Use when interacting with Gitea via command line - managing issues, PRs, releases, repos, or any git forge operations with tea CLI
This skill inherits all available tools. When active, it can use any tool Claude has access to.
references/authentication.mdreferences/commands.mdreferences/workflows.mdTea 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.
# 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.
| 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 |
See references/commands.md for complete command reference:
See references/workflows.md for patterns:
tea issues --output json # JSON
tea issues --output yaml # YAML
tea issues --output csv # CSV
tea issues --output simple # Plain text
Tea auto-detects repo from current directory's git remote. Override with:
tea issues --repo owner/repo
tea issues --login myserver # specific Gitea instance
| 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 |