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 |
