Files

Add new frontmatter fields from Claude Code 2.1.0

Update documentation and apply new frontmatter capabilities:

Documentation:
- Add user-invocable, context, agent, hooks fields to writing-skills.md
- Add disallowedTools, permissionMode, hooks fields to writing-agents.md
- Add model, context, hooks, allowed-tools fields to writing-commands.md
- Document skill hot-reload, built-in agents, background execution

Skills:
- Add user-invocable: false to gitea (CLI reference)
- Add user-invocable: false to repo-conventions (standards reference)

Commands:
- Add context: fork to heavy exploration commands (improve, plan-issues,
  create-repo, update-claude-md)
- Add missing argument-hint to roadmap, manifesto, improve

Agents:
- Add disallowedTools: [Edit, Write] to code-reviewer for safety

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-08 14:19:56 +01:00

5.9 KiB

Raw Blame History

name, description, user-invocable

name	description	user-invocable
gitea	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

Gitea CLI (tea)

Command-line interface for interacting with Gitea repositories.

Installation

brew install tea

Authentication

The tea CLI authenticates via tea logins add. Credentials are stored locally by tea.

tea logins add                       # Interactive login
tea logins add --url <url> --token <token> --name <name>  # Non-interactive
tea logins list                      # Show configured logins
tea logins default <name>            # Set default login

Configuration

Config is stored at ~/Library/Application Support/tea/config.yml (macOS).

To avoid needing --login on every command, set defaults:

preferences:
    editor: false
    flag_defaults:
        remote: origin
        login: git.flowmade.one

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.

Common Commands

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

Repository

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

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.

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

Actions / CI

# List workflow runs
tea actions runs                     # List all workflow runs
tea actions runs -o json             # JSON output for parsing

# List jobs for a run
tea actions jobs <run-id>            # Show jobs for a specific run
tea actions jobs <run-id> -o json    # JSON output

# Get job logs
tea actions logs <job-id>            # Display logs for a job

# Full workflow: find failed job logs
tea actions runs                     # Find the run ID
tea actions jobs <run-id>            # Find the job ID
tea actions logs <job-id>            # View the logs

5.9 KiB Raw Blame History