shield_lock
JinDaGe
← Back to skills
extension
Category: Development & EngineeringNo API key required

tea-cli

Use when interacting with Gitea via command line - managing issues, PRs, releases, repos, or any git forge operations with tea CLI

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

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 |