Skip to content
gitea logo

gitea

Gitea operations via tea CLI. Use when user mentions: gitea, tea, or when git remote shows a Gitea instance.

SKILL.md

Full skill instructions

Gitea CLI (tea)

When to Use This Skill

Use tea for Gitea repositories. To detect Gitea, check if the remote is not GitHub or GitLab:

git remote -v

If the remote doesn't contain github.com or gitlab, it may be a Gitea instance.

Before Any Operation

Always verify authentication first:

tea login list

If not authenticated, guide the user to run tea login add.

Behavioral Guidelines

  1. Creating PRs: Always check for uncommitted changes first with git status
  2. CI Operations: Check pipeline status before triggering new runs
  3. Use --output: For machine-readable output, use -o json or -o yaml

Command Reference

Pull Requests

ActionCommand
Createtea pr create --title "Title" --description "Desc"
Listtea pr list
Viewtea pr view <id>
Checkouttea pr checkout <id>
Mergetea pr merge <id>

Issues

ActionCommand
Createtea issue create --title "Title" --body "Desc"
Listtea issue list
List opentea issue list --state open
Viewtea issue view <id>
Closetea issue close <id>
Commenttea issue comment <id> "Comment"

Repository

ActionCommand
Clonetea repo clone <owner/​repo>
Forktea repo fork <owner/​repo>

Output Formats

For JSON output (useful for scripting):

tea issue list -o json
tea pr list -o json