otty / apps

All apps/Tea

Tea

tea

The official command-line interface for Gitea.

Runs as tea|macOS, Linux, Windows|about.gitea.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

Tea in your home directory Every rule on this page, by file

logins.*.tokenlogins.*.refresh_token

Lifted into your secret store; the rest of the file syncs.

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/tea/otty.tomlThe file this page is generated from

id = "tea"

name = "Tea"

homepage = "https://about.gitea.com/products/tea/"

description = "The official command-line interface for Gitea."

executables = ["tea"]

[dotfiles]

# https://gitea.cn/gitea/tea (the official Gitea mirror) documents that Tea

# persists configuration in $XDG_CONFIG_HOME/tea. The Go package docs at

# https://pkg.go.dev/code.gitea.io/tea/modules/config describe config.yml's

# logins, preferences and token fields.

paths = ["[configHome]/tea/config.yml"]

exclude = []

secret = []

side_effect = false

# Plain-token logins are credentials; OAuth tokens may instead be in the OS

# credential store, so only the documented YAML token fields are lifted.

[[dotfiles.secret_paths]]

file = "[configHome]/tea/config.yml"

match = { key_path = ["logins.*.token", "logins.*.refresh_token"] }

[commands]

format = 1

label = "Gitea CLI"

description = "Common tea jobs: list issues, create an issue, create a pull request. Login management, reviews, releases and the other subcommands are outside this form."

quality = "ai-draft"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]

path = ["issues", "list"]

label = "List issues"

description = "List issues of the repository. Fields and paging beyond the ones shown are left out."

[[commands.subcommand.source]]

id = "tea-cli"

kind = "manual"

url = "https://gitea.com/gitea/tea/raw/branch/main/docs/CLI.md"

revision = "main 2026-10-27"

evidence = """

### list, ls

List issues of the repository

**--assignee, -a**="":

**--author, -A**="":

**--keyword, -k**="": Filter by search string

**--labels, -L**="": Comma-separated list of labels to match issues against.

**--limit, --lm**="": specify limit of items per page (default: 30)

**--milestones, -m**="": Comma-separated list of milestones to match issues against.

**--output, -o**="": Output format. (simple, table, csv, tsv, yaml, json)

**--repo, -r**="": Override local repository path or gitea repository slug to interact with. Optional

**--state**="": Filter by state (all|open|closed)

"""

[[commands.subcommand.field]]

id = "state"

label = "State"

type = "enum"

option = ["--state"]

choices = [{ value = "all", label = "All" }, { value = "open", label = "Open" }, { value = "closed", label = "Closed" }]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "keyword"

label = "Search text"

type = "string"

option = ["--keyword", "-k"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "labels"

label = "Labels"

description = "Comma-separated list of labels."

type = "string"

option = ["--labels", "-L"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "milestones"

label = "Milestones"

description = "Comma-separated list of milestones."

type = "string"

option = ["--milestones", "-m"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "assignee"

label = "Assignee"

type = "string"

option = ["--assignee", "-a"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "author"

label = "Author"

type = "string"

option = ["--author", "-A"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "limit"

label = "Items per page"

type = "integer"

option = ["--limit", "--lm"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "output"

label = "Output format"

type = "enum"

option = ["--output", "-o"]

choices = [{ value = "simple", label = "Simple" }, { value = "table", label = "Table" }, { value = "csv", label = "CSV" }, { value = "tsv", label = "TSV" }, { value = "yaml", label = "YAML" }, { value = "json", label = "JSON" }]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "repo"

label = "Repository"

description = "Local repository path or Gitea repository slug."

type = "string"

option = ["--repo", "-r"]

sources = ["tea-cli"]

[[commands.subcommand.task]]

id = "open"

label = "Open issues"

fields = ["state", "labels", "repo"]

set = { state = ["open"] }

[[commands.subcommand.task]]

id = "json"

label = "Export as JSON"

fields = ["state", "output", "repo"]

set = { output = ["json"] }

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["state", "keyword", "labels", "repo"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["milestones", "assignee", "author", "limit", "output"]

[[commands.subcommand]]

path = ["issues", "create"]

label = "Create an issue"

description = "Create an issue on the repository. Deadline and referenced-version options are left out."

[[commands.subcommand.source]]

id = "tea-cli"

kind = "manual"

url = "https://gitea.com/gitea/tea/raw/branch/main/docs/CLI.md"

revision = "main 2026-10-27"

evidence = """

### create, c

Create an issue on repository

**--assignees, -a**="": Comma-separated list of usernames to assign

**--description, -d**="":

**--description-file**="": Read description from file ('-' for stdin)

**--labels, -L**="": Comma-separated list of labels to assign

**--milestone, -m**="": Milestone to assign

**--repo, -r**="": Override local repository path or gitea repository slug to interact with. Optional

**--title, -t**="":

"""

[[commands.subcommand.field]]

id = "title"

label = "Title"

type = "string"

option = ["--title", "-t"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "description"

label = "Description"

type = "string"

option = ["--description", "-d"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "description_file"

label = "Description file"

type = "path"

option = ["--description-file"]

path = { kind = "file", role = "input" }

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "labels"

label = "Labels"

description = "Comma-separated list of labels."

type = "string"

option = ["--labels", "-L"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "assignees"

label = "Assignees"

description = "Comma-separated list of usernames."

type = "string"

option = ["--assignees", "-a"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "milestone"

label = "Milestone"

type = "string"

option = ["--milestone", "-m"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "repo"

label = "Repository"

description = "Local repository path or Gitea repository slug."

type = "string"

option = ["--repo", "-r"]

sources = ["tea-cli"]

[[commands.subcommand.task]]

id = "simple"

label = "Title and description"

fields = ["title", "description", "repo"]

required = ["title"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["title", "description", "description_file", "repo"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["labels", "assignees", "milestone"]

[[commands.subcommand]]

path = ["pulls", "create"]

label = "Create a pull request"

description = "Create a pull request from the current or a given branch. Agit flow and deadline options are left out."

[[commands.subcommand.source]]

id = "tea-cli"

kind = "manual"

url = "https://gitea.com/gitea/tea/raw/branch/main/docs/CLI.md"

revision = "main 2026-10-27"

evidence = """

### create, c

Create a pull-request

**--allow-maintainer-edits, --edits**: Enable maintainers to push to the base branch of created pull

**--assignees, -a**="": Comma-separated list of usernames to assign

**--base, -b**="": Branch name of the PR target (default is repos default branch)

**--description, -d**="":

**--draft**: Create as a draft (prepends "WIP: " to the title; Gitea treats WIP-prefixed PRs as drafts)

**--head**="": Branch name of the PR source (default is current one). To specify a different head repo, use <user>:<branch>

**--labels, -L**="": Comma-separated list of labels to assign

**--milestone, -m**="": Milestone to assign

**--repo, -r**="": Override local repository path or gitea repository slug to interact with. Optional

**--title, -t**="":

"""

[[commands.subcommand.field]]

id = "title"

label = "Title"

type = "string"

option = ["--title", "-t"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "description"

label = "Description"

type = "string"

option = ["--description", "-d"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "base"

label = "Target branch"

description = "Defaults to the repository's default branch."

type = "string"

option = ["--base", "-b"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "head"

label = "Source branch"

description = "Defaults to the current branch; use user:branch for another head repository."

type = "string"

option = ["--head"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "draft"

label = "Draft"

type = "boolean"

option = ["--draft"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "edits"

label = "Allow maintainer edits"

type = "boolean"

option = ["--allow-maintainer-edits", "--edits"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "labels"

label = "Labels"

description = "Comma-separated list of labels."

type = "string"

option = ["--labels", "-L"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "assignees"

label = "Assignees"

description = "Comma-separated list of usernames."

type = "string"

option = ["--assignees", "-a"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "milestone"

label = "Milestone"

type = "string"

option = ["--milestone", "-m"]

sources = ["tea-cli"]

[[commands.subcommand.field]]

id = "repo"

label = "Repository"

description = "Local repository path or Gitea repository slug."

type = "string"

option = ["--repo", "-r"]

sources = ["tea-cli"]

[[commands.subcommand.task]]

id = "pr"

label = "Pull request"

fields = ["title", "description", "base", "repo"]

required = ["title"]

[[commands.subcommand.task]]

id = "draft_pr"

label = "Draft pull request"

fields = ["title", "description", "base", "draft", "repo"]

required = ["title"]

set = { draft = [true] }

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["title", "description", "base", "head", "draft", "repo"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["edits", "labels", "assignees", "milestone"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/tea. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.