# 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) |