Claude Code Plugins

Community-maintained marketplace

Feedback

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

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

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

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