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

Command form

ai-draft · 5 tasks · 26 fields

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

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui tea

tea issues list

List issues

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

List issuesExample values, fixed in this page — nothing here reaches a terminal
Basic
State
Openenum
Labels
string
Repository
string
TasksEach one presets the form for one job
Open issues
statelabelsrepo
Export as JSON
stateoutputrepo
ParametersOnly these flags are editable in the form
State
enum
--stateallopenclosed
Search text
string
--keyword-k
Labels
Comma-separated list of labels.
string
--labels-L
Milestones
Comma-separated list of milestones.
string
--milestones-m
Assignee
string
--assignee-a
Author
string
--author-A
Items per page
integer
--limit--lm
Output format
enum
--output-osimpletablecsvtsvyamljson
Repository
Local repository path or Gitea repository slug.
string
--repo-r

tea issues create

Create an issue

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

Create an issueExample values, fixed in this page — nothing here reaches a terminal
Basic
Title*
string
Description
string
Repository
string
TasksEach one presets the form for one job
Title and description
titledescriptionrepo
ParametersOnly these flags are editable in the form
Title
string
--title-t
Description
string
--description-d
Description file
path
--description-file
Labels
Comma-separated list of labels.
string
--labels-L
Assignees
Comma-separated list of usernames.
string
--assignees-a
Milestone
string
--milestone-m
Repository
Local repository path or Gitea repository slug.
string
--repo-r

tea pulls create

Create a pull request

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

Create a pull requestExample values, fixed in this page — nothing here reaches a terminal
Basic
Title*
string
Description
string
Target branch
string
Repository
string
TasksEach one presets the form for one job
Pull request
titledescriptionbaserepo
Draft pull request
titledescriptionbasedraftrepo
ParametersOnly these flags are editable in the form
Title
string
--title-t
Description
string
--description-d
Target branch
Defaults to the repository's default branch.
string
--base-b
Source branch
Defaults to the current branch; use user:branch for another head repository.
string
--head
Draft
boolean
--draft
Allow maintainer edits
boolean
--allow-maintainer-edits--edits
Labels
Comma-separated list of labels.
string
--labels-L
Assignees
Comma-separated list of usernames.
string
--assignees-a
Milestone
string
--milestone-m
Repository
Local repository path or Gitea repository slug.
string
--repo-r
SourcesEvery flag above is checked against these
tea-cli
### 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…
manualmain 2026-10-27

gitea.com

tea-cli
### 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 repos…
manualmain 2026-10-27

gitea.com

tea-cli
### 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…
manualmain 2026-10-27

gitea.com

Before it fills your prompt, Otty checks the installed tea against its version. A form that does not match your version is not offered.