OpenParable
Skip to content
← Back to skills

Tea CLI

Apps & Automation
tea-cli

Tea 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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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

TaskCommand
Issues
List issuestea issues
Create issuetea issues create --title "Bug" --body "Details"
Close issuetea issues close 123
Pull Requests
List PRstea pr
Create PRtea pr create --head feature --base main
Checkout PRtea pr checkout 45
Merge PRtea pr merge 45
Review PRtea pr review 45 --approve
Releases
List releasestea releases
Create releasetea release create --tag v1.0.0 --title "Release"
Upload assettea release assets create --tag v1.0.0 FILE
Repos
List repostea repos
Create repotea repos create --name myrepo
Clone repotea clone owner/repo
Fork repotea 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

ProblemSolution
"not logged in"Run tea login add first
Wrong repo contextUse --repo owner/repo flag
Can't find PRCheck --state flag (open/closed/all)
Token expiredRe-run tea login add with new token