tea Command Reference
Quick-lookup table of all tea commands and their subcommands.
Table of Contents
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) |