---

name: gitea description: "Interact with Gitea using the tea CLI. Use tea issues, tea pulls, tea releases, and other commands for issues, PRs, releases, and repository management."

Gitea Skill

Use the tea CLI to interact with Gitea servers. Use --repo owner/repo when not in a git directory, or --login instance.com to specify a Gitea instance.

Setup

Add a login once to get started:

tea login add

Check current logged in user:

tea whoami

Repositories

List repositories you have access to:

tea repos list

Create a new repository:

tea repos create --name my-repo --description "My project" --init

Create a private repository:

tea repos create --name my-repo --private --init

Fork a repository:

tea repos fork owner/repo

Delete a repository:

tea repos delete --name my-repo --owner myuser --force

Pull Requests

List open pull requests:

tea pulls --repo owner/repo

View a specific PR:

tea pr 55 --repo owner/repo

Checkout a PR locally:

tea pr checkout 55

Create a new PR:

tea pr create --title "Feature title" --description "Description"

Issues

List open issues:

tea issues --repo owner/repo

View a specific issue:

tea issue 189 --repo owner/repo

Create a new issue:

tea issue create --title "Bug title" --body "Description"

View issues for a milestone:

tea milestone issues 0.7.0

Comments

Add a comment to an issue or PR:

tea comment 189 --body "Your comment here"

Releases

List releases:

tea releases --repo owner/repo

Create a new release:

tea release create --tag v1.0.0 --title "Release 1.0.0"

Actions (CI/CD)

List repository action secrets:

tea actions secrets list

Create a new secret:

tea actions secrets create API_KEY

List action variables:

tea actions variables list

Set an action variable:

tea actions variables set API_URL https://api.example.com

Webhooks

List repository webhooks:

tea webhooks list

List organization webhooks:

tea webhooks list --org myorg

Create a webhook:

tea webhooks create https://example.com/hook --events push,pull_request

Other Entities

List branches:

tea branches --repo owner/repo

List labels:

tea labels --repo owner/repo

List milestones:

tea milestones --repo owner/repo

List organizations:

tea organizations

Show repository details:

tea repo --repo owner/repo

Helpers

Open something in browser:

tea open 189                 # open issue/PR 189
tea open milestones          # open milestones page

Clone a repository:

tea clone owner/repo

Show notifications:

tea notifications --mine

Output Formats

Use --output or -o to control output format:

tea issues --output simple   # simple text output
tea issues --output csv      # CSV format
tea issues --output yaml     # YAML format