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 json or -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
