Full operability skill for the tea Gitea CLI — covers issues, PRs, repos, releases, branches, actions, webhooks, notifications, orgs, time tracking, and raw API access. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
243 lines
8.1 KiB
Markdown
243 lines
8.1 KiB
Markdown
# tea Command Reference
|
|
|
|
Quick-lookup table of all `tea` commands and their subcommands.
|
|
|
|
## Table of Contents
|
|
- [Issues](#issues)
|
|
- [Pull Requests](#pull-requests)
|
|
- [Labels](#labels)
|
|
- [Milestones](#milestones)
|
|
- [Releases](#releases)
|
|
- [Times](#times)
|
|
- [Organizations](#organizations)
|
|
- [Repos](#repos)
|
|
- [Branches](#branches)
|
|
- [Actions](#actions)
|
|
- [Webhooks](#webhooks)
|
|
- [Notifications](#notifications)
|
|
- [Helpers](#helpers)
|
|
- [Setup](#setup)
|
|
- [Misc](#misc)
|
|
|
|
---
|
|
|
|
## Issues
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea issues` | `issue`, `i` | List or view issues |
|
|
| `tea issues list` | `ls` | List issues |
|
|
| `tea issues create` | `c` | Create an issue |
|
|
| `tea issues edit` | `e` | Edit one or more issues |
|
|
| `tea issues close` | | Close issues |
|
|
| `tea issues reopen` | `open` | Reopen issues |
|
|
| `tea comment <index>` | `c` | Add comment to issue/PR |
|
|
|
|
**Filters:** `--state`, `--kind issues|pulls|all`, `--keyword`, `--labels`, `--milestones`, `--author`, `--assignee`, `--mentions`, `--from`, `--until`
|
|
|
|
---
|
|
|
|
## Pull Requests
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea pulls` | `pull`, `pr` | List or view PRs |
|
|
| `tea pulls list` | `ls` | List PRs |
|
|
| `tea pulls create` | `c` | Create a PR |
|
|
| `tea pulls checkout` | `co` | Check out PR branch locally |
|
|
| `tea pulls review` | | Interactive review |
|
|
| `tea pulls approve` | `lgtm`, `a` | Approve a PR |
|
|
| `tea pulls reject` | | Request changes |
|
|
| `tea pulls merge` | `m` | Merge a PR |
|
|
| `tea pulls edit` | `e` | Edit PR metadata |
|
|
| `tea pulls close` | | Close a PR |
|
|
| `tea pulls reopen` | `open` | Reopen a PR |
|
|
| `tea pulls clean` | | Delete merged feature branch |
|
|
|
|
---
|
|
|
|
## Labels
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea labels` | `label` | List/manage labels |
|
|
| `tea labels list` | `ls` | List labels |
|
|
| `tea labels create` | `c` | Create a label |
|
|
| `tea labels update` | | Update a label |
|
|
| `tea labels delete` | `rm` | Delete a label |
|
|
|
|
---
|
|
|
|
## Milestones
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea milestones` | `milestone`, `ms` | List/manage milestones |
|
|
| `tea milestones list` | `ls` | List milestones |
|
|
| `tea milestones create` | `c` | Create a milestone |
|
|
| `tea milestones close` | | Close milestones |
|
|
| `tea milestones reopen` | `open` | Reopen milestones |
|
|
| `tea milestones delete` | `rm` | Delete a milestone |
|
|
| `tea milestones issues` | `i` | List issues in milestone |
|
|
|
|
---
|
|
|
|
## Releases
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea releases` | `release`, `r` | List/manage releases |
|
|
| `tea releases list` | `ls` | List releases |
|
|
| `tea releases create` | `c` | Create a release |
|
|
| `tea releases edit` | `e` | Edit a release |
|
|
| `tea releases delete` | `rm` | Delete a release |
|
|
| `tea releases assets` | `asset`, `a` | Manage release assets |
|
|
| `tea releases assets list` | `ls` | List assets |
|
|
| `tea releases assets create` | `c` | Upload asset |
|
|
| `tea releases assets delete` | `rm` | Delete asset |
|
|
|
|
---
|
|
|
|
## Times
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea times` | `time`, `t` | List/manage time tracking |
|
|
| `tea times list` | `ls` | List tracked times |
|
|
| `tea times add` | `a` | Add tracked time to issue |
|
|
| `tea times delete` | `rm` | Delete a tracked time entry |
|
|
| `tea times reset` | | Reset all tracked time on issue |
|
|
|
|
---
|
|
|
|
## Organizations
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea organizations` | `organization`, `org` | List/manage orgs |
|
|
| `tea orgs list` | `ls` | List organizations |
|
|
| `tea orgs create` | `c` | Create an organization |
|
|
| `tea orgs delete` | `rm` | Delete an organization |
|
|
|
|
---
|
|
|
|
## Repos
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea repos` | `repo` | List/manage repos |
|
|
| `tea repos list` | `ls` | List accessible repos |
|
|
| `tea repos search` | `s` | Search repos on instance |
|
|
| `tea repos create` | `c` | Create a repo |
|
|
| `tea repos create-from-template` | `ct` | Create from template |
|
|
| `tea repos fork` | `f` | Fork a repo |
|
|
| `tea repos migrate` | `m` | Migrate repo from external source |
|
|
| `tea repos delete` | `rm` | Delete a repo |
|
|
| `tea repos edit` | `e` | Edit repo properties |
|
|
|
|
---
|
|
|
|
## Branches
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea branches` | `branch`, `b` | List/manage branches |
|
|
| `tea branches list` | `ls` | List branches |
|
|
| `tea branches protect` | `P` | Protect a branch |
|
|
| `tea branches unprotect` | `U` | Remove branch protection |
|
|
|
|
---
|
|
|
|
## Actions
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea actions` | `action` | Manage CI/CD |
|
|
| `tea actions runs` | `run` | Manage workflow runs |
|
|
| `tea actions runs list` | `ls` | List runs |
|
|
| `tea actions runs view` | `show`, `get` | View run details |
|
|
| `tea actions runs logs` | `log` | View run logs |
|
|
| `tea actions runs cancel` | `delete`, `rm` | Cancel/delete a run |
|
|
| `tea actions secrets` | `secret` | Manage secrets |
|
|
| `tea actions secrets list` | `ls` | List secrets |
|
|
| `tea actions secrets create` | `add`, `set` | Create/update secret |
|
|
| `tea actions secrets delete` | `rm` | Delete secret |
|
|
| `tea actions variables` | `variable`, `vars`, `var` | Manage variables |
|
|
| `tea actions variables list` | `ls` | List variables |
|
|
| `tea actions variables create` | `add`, `set` | Create/update variable |
|
|
| `tea actions variables delete` | `rm` | Delete variable |
|
|
| `tea actions workflows` | `workflow` | List workflows |
|
|
|
|
---
|
|
|
|
## Webhooks
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea webhooks` | `webhook`, `hooks`, `hook` | Manage webhooks |
|
|
| `tea webhooks list` | `ls` | List webhooks |
|
|
| `tea webhooks create` | `c` | Create a webhook |
|
|
| `tea webhooks update` | `edit`, `u` | Update a webhook |
|
|
| `tea webhooks delete` | `rm` | Delete a webhook |
|
|
|
|
Scopes: `--repo`, `--org`, or `--global`
|
|
|
|
---
|
|
|
|
## Notifications
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea notifications` | `notification`, `n` | Manage notifications |
|
|
| `tea notifications list` | `ls` | List notifications |
|
|
| `tea notifications read` | `r` | Mark as read |
|
|
| `tea notifications unread` | `u` | Mark as unread |
|
|
| `tea notifications pin` | `p` | Pin notification |
|
|
| `tea notifications unpin` | | Unpin notification |
|
|
|
|
**Filters:** `--types issue|pull|repository|commit`, `--states pinned|unread|read`, `--mine`
|
|
|
|
---
|
|
|
|
## Helpers
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea open` | `o` | Open repo in browser |
|
|
| `tea notifications` | `n` | Show notifications |
|
|
| `tea clone` | `C` | Clone a repo |
|
|
| `tea api` | | Raw authenticated API call |
|
|
|
|
### tea api flags
|
|
| Flag | Description |
|
|
|------|-------------|
|
|
| `-X method` | HTTP method (GET/POST/PUT/PATCH/DELETE) |
|
|
| `-f key=value` | String field in request body |
|
|
| `-F key=value` | Typed field (number/bool/null/JSON) |
|
|
| `-H key:value` | Custom header |
|
|
| `-d '{"json"...}'` | Raw JSON body |
|
|
| `-i` / `--include` | Include HTTP response headers |
|
|
| `-o file` | Write response to file |
|
|
|
|
---
|
|
|
|
## Setup
|
|
| Command | Aliases | Description |
|
|
|---------|---------|-------------|
|
|
| `tea logins` | `login` | Manage Gitea logins |
|
|
| `tea logins list` | `ls` | List saved logins |
|
|
| `tea logins add` | | Add a login |
|
|
| `tea logins edit` | `e` | Edit a login |
|
|
| `tea logins delete` | `rm` | Remove a login |
|
|
| `tea logins default` | | Get or set default login |
|
|
| `tea logins oauth-refresh` | | Refresh OAuth token |
|
|
| `tea logout` | | Log out |
|
|
|
|
---
|
|
|
|
## Misc
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `tea whoami` | Show current logged-in user |
|
|
| `tea admin users` | Manage users (requires admin) |
|
|
|
|
---
|
|
|
|
## Global flags (all commands)
|
|
| Flag | Description |
|
|
|------|-------------|
|
|
| `--repo`, `-r` | Override repo (path or owner/name slug) |
|
|
| `--remote`, `-R` | Use specific git remote for login discovery |
|
|
| `--login`, `-l` | Use a specific saved login |
|
|
| `--output`, `-o` | Output format: `table`, `simple`, `csv`, `tsv`, `json`, `yaml` |
|
|
| `--page`, `-p` | Page number for paginated results |
|
|
| `--limit`, `--lm` | Items per page |
|
|
| `--debug`, `--vvv` | Enable debug mode (shows API calls) |
|