gitea

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