| name | tea-cli |
| description | Use when interacting with Gitea via command line - managing issues, PRs, releases, repos, or any git forge operations with tea CLI |
Tea CLI for Gitea
Overview
Tea is the official CLI for Gitea. Use it for quick operations, scripting, and CI/CD workflows. For complex automation or custom integrations, use the gitea:go-sdk skill instead.
Quick Setup
# Install
brew install tea # or: go install code.gitea.io/tea@latest
# Authenticate
tea login add --name myserver --url https://gitea.example.com --token YOUR_TOKEN
See references/authentication.md for detailed auth options.
Quick Reference
| Task | Command |
|---|---|
| Issues | |
| List issues | tea issues |
| Create issue | tea issues create --title "Bug" --body "Details" |
| Close issue | tea issues close 123 |
| Pull Requests | |
| List PRs | tea pr |
| Create PR | tea pr create --head feature --base main |
| Checkout PR | tea pr checkout 45 |
| Merge PR | tea pr merge 45 |
| Review PR | tea pr review 45 --approve |
| Releases | |
| List releases | tea releases |
| Create release | tea release create --tag v1.0.0 --title "Release" |
| Upload asset | tea release assets create --tag v1.0.0 FILE |
| Repos | |
| List repos | tea repos |
| Create repo | tea repos create --name myrepo |
| Clone repo | tea clone owner/repo |
| Fork repo | tea repos fork owner/repo |
Command Categories
See references/commands.md for complete command reference:
- Issues & comments
- Pull requests & reviews
- Releases & assets
- Repositories & branches
- Labels, milestones, organizations
- Webhooks, notifications, time tracking
- Actions (secrets/variables)
Common Workflows
See references/workflows.md for patterns:
- Feature branch to merged PR
- Release with assets
- Issue triage
- Multi-instance management
Output Formats
tea issues --output json # JSON
tea issues --output yaml # YAML
tea issues --output csv # CSV
tea issues --output simple # Plain text
Repository Context
Tea auto-detects repo from current directory's git remote. Override with:
tea issues --repo owner/repo
tea issues --login myserver # specific Gitea instance
Common Mistakes
| Problem | Solution |
|---|---|
| "not logged in" | Run tea login add first |
| Wrong repo context | Use --repo owner/repo flag |
| Can't find PR | Check --state flag (open/closed/all) |
| Token expired | Re-run tea login add with new token |