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