tea

Log in to a Gitea instance

$ tea login add --url [https://gitea.example.com] --token [your_token]

$ tea issues

$ tea issues create --title "[Bug report]" --body "[Description]"

$ tea pulls

$ tea pulls create --title "[Feature]" --base [main] --head [feature-branch]

$ tea pulls checkout [42]

$ tea repos

$ tea clone [owner/repo]

tea command [subcommand] [options]

tea is a command-line client for interacting with Gitea servers. It provides functionality similar to GitHub's gh CLI, allowing management of repositories, issues, pull requests, and other entities directly from the terminal.
The tool uses context from the current git repository when available, detecting the remote Gitea server and repository automatically. It works best with an upstream/fork workflow where the local main branch tracks the upstream repository.
Multiple Gitea instances can be configured via tea logins add, with one set as default. Configuration is stored in $XDG_CONFIG_HOME/tea (typically ~/.config/tea).
Useful commands include tea pulls checkout to fetch and switch to a PR branch locally, and tea open to quickly open the current repository in a web browser.

--login, -l name

Use a specific login configuration

Specify repository (default: detected from current directory)

Output format: simple, table, csv, tsv, yaml, json

Show help for command

Show version

logins

Manage Gitea server authentications (add, list, delete, default)

Remove authentication from a Gitea server

Display currently authenticated user

Create, list, and manage issues (create, list, edit, close, reopen)

Manage pull requests (create, list, checkout, merge, approve, reject)

Display and manage repositories (list, create, fork, delete, migrate)

Examine and manage branches (list, protect, unprotect)

Manage issue labels (create, list, update, delete)

Track project milestones (create, list, close, reopen)

Manage releases (create, list, delete, edit, assets)

Manage organizations (list, create, delete)

Track time on issues

View and manage notifications

Add comments to issues or pull requests

Open repository in web browser

Clone a repository

tea assumes local git state is published to the remote before performing operations. Some commands require appropriate permissions on the Gitea server. The tool is designed specifically for Gitea and may not work with other forges.

tea was developed by the Gitea project as the official command-line interface for Gitea servers. Written in Go, it uses the Gitea SDK to interact with the Gitea API. The project is hosted on Gitea's own platform at gitea.com/gitea/tea.

git(1), gh(1), glab(1), hub(1)