Gitea CLI (tea)
When to Use This Skill
Use tea for Gitea repositories. To detect Gitea, check if the remote is not GitHub or GitLab:
git remote -v
If the remote doesn't contain github.com or gitlab, it may be a Gitea instance.
Before Any Operation
Always verify authentication first:
tea login list
If not authenticated, guide the user to run tea login add.
Behavioral Guidelines
- Creating PRs: Always check for uncommitted changes first with
git status - CI Operations: Check pipeline status before triggering new runs
- Use
--output: For machine-readable output, use-o jsonor-o yaml
Command Reference
Pull Requests
| Action | Command |
|--------|---------|
| Create | tea pr create --title "Title" --description "Desc" |
| List | tea pr list |
| View | tea pr view <id> |
| Checkout | tea pr checkout <id> |
| Merge | tea pr merge <id> |
Issues
| Action | Command |
|--------|---------|
| Create | tea issue create --title "Title" --body "Desc" |
| List | tea issue list |
| List open | tea issue list --state open |
| View | tea issue view <id> |
| Close | tea issue close <id> |
| Comment | tea issue comment <id> "Comment" |
Repository
| Action | Command |
|--------|---------|
| Clone | tea repo clone <owner/repo> |
| Fork | tea repo fork <owner/repo> |
Output Formats
For JSON output (useful for scripting):
tea issue list -o json
tea pr list -o json