Files
architecture/skills/gitea/SKILL.md
Hugo Nijhuis f99f8f072e chore: update model names and gitea allowed-tools
- Use full model names (claude-haiku-4-5, etc.) in create-capability
- Add allowed-tools to gitea skill for tea/jq commands
- Set default model to opus in settings

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 23:45:51 +01:00

4.9 KiB

name, model, description, user-invocable, allowed-tools
name model description user-invocable allowed-tools
gitea claude-haiku-4-5 View, create, and manage Gitea issues and pull requests using tea CLI. Use when working with issues, PRs, viewing issue details, creating pull requests, adding comments, merging PRs, or when the user mentions tea, gitea, issue numbers, or PR numbers. false
Bash(tea*)
Bash(jq*)

Gitea CLI (tea)

Command-line interface for Gitea repositories. Use tea for issue/PR management in Gitea instances.

Setup required? See reference/setup.md for installation and authentication.

Repository Detection

tea automatically detects the repository from git remotes when run inside a git repository. Use --remote <name> to specify which remote to use.

Issues

# List issues
tea issues                           # Open issues (default)
tea issues --state all               # All issues
tea issues --state closed            # Closed issues

# View issue details
tea issues <number>                  # Full issue details
tea issues <number> --comments       # Include comments

# Create issue
tea issues create --title "<title>" --description "<body>"
tea issues create -t "<title>" -d "<body>"

# Edit issue
tea issues edit <number> --title "<new-title>"
tea issues edit <number> --description "<new-body>"

# Close/reopen
tea issues close <number>
tea issues reopen <number>

# Labels
tea issues edit <number> --labels "bug,help wanted"

# Dependencies
tea issues deps list <number>              # List blockers for an issue
tea issues deps add <issue> <blocker>      # Add dependency (issue is blocked by blocker)
tea issues deps add 5 3                    # Issue #5 depends on #3
tea issues deps add 5 owner/repo#3         # Cross-repo dependency
tea issues deps remove <issue> <blocker>   # Remove a dependency

Pull Requests

# List PRs
tea pulls                            # Open PRs (default)
tea pulls --state all                # All PRs
tea pulls --state closed             # Closed/merged PRs

# View PR
tea pulls <number>                   # PR details
tea pulls <number> --comments        # Include comments

# View PR diff (tea doesn't have a diff command, use git)
tea pulls checkout <number>          # First checkout the PR branch
git diff main...HEAD                 # Diff against main branch

# Create PR
tea pulls create --title "<title>" --description "<body>"
tea pulls create -t "<title>" -d "<body>"
tea pulls create -t "<title>" -d "Closes #<issue>"
tea pulls create --head <branch> --base main -t "<title>"

# Checkout PR locally
tea pulls checkout <number>

# Review/Approve
tea pulls approve <number>           # Approve PR (LGTM)
tea pulls reject <number>            # Request changes
tea pulls review <number>            # Interactive review

# Merge
tea pulls merge <number>                      # Default merge
tea pulls merge <number> --style squash       # Squash commits
tea pulls merge <number> --style rebase       # Rebase commits
tea pulls merge <number> --style rebase-merge # Rebase then merge

# Clean up after merge
tea pulls clean <number>             # Delete local & remote branch

Comments

# Add comment to issue or PR
tea comment <number> "<comment body>"
tea comment 3 "LGTM, ready to merge"

# Multiline comments (use quoted strings with literal newlines)
tea comment 3 "## Review Summary

- Code looks good
- Tests pass"

Warning

: Do not use heredoc syntax $(cat <<'EOF'...EOF) with tea comment - it causes the command to be backgrounded and fail silently.

Repository

tea repos                            # List repos
tea repos <owner>/<repo>             # Repository info
tea clone <owner>/<repo>             # Clone repository

Notifications

tea notifications                    # List notifications
tea notifications --mine             # Only participating

Output Formatting

Most commands support --output or -o flag:

  • -o simple - Plain text
  • -o table - Tabular format (default)
  • -o json - Machine-readable JSON
  • -o yaml - YAML format
  • -o csv - CSV format

Specifying Remote/Login

tea issues --remote gitea            # Use specific git remote
tea issues --login myserver          # Use specific login
tea issues -r owner/repo             # Specify repo directly

Tips

  • View single issue: Use tea issues <number> (NOT tea issues view <number> - there is no view subcommand)
  • PR description flag: Use --description or -d (NOT --body like gh CLI)
  • Always verify you're in the correct repository before running commands
  • Use tea issues to find issue numbers before viewing/editing
  • Reference issues in PR bodies with Closes #N for auto-linking
  • Use --remote gitea when you have multiple remotes (e.g., origin + gitea)
  • The tea pulls checkout command is handy for reviewing PRs locally

Advanced Topics