tea-skill/tea/references/commands.md

tea Command Reference

Quick-lookup table of all tea commands and their subcommands.

Table of Contents

• Issues
• Pull Requests
• Labels
• Milestones
• Releases
• Times
• Organizations
• Repos
• Branches
• Actions
• Webhooks
• Notifications
• Helpers
• Setup
• 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)