Tea CLI
Apps & Automationtea-cliTea CLI is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when interacting with Gitea via command line - managing issues, PRs, releases, repos, or any git forge operations with tea CLI
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/tea-cli/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/tea-cli, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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 |