Cheatsheets:Tea - Revision history

Rongzhou: /* Repos */

2026-08-31T12:36:51Z

Repos

← Older revision		Revision as of 12:36, 31 August 2026
Line 112:		Line 112:
	tea repo search witches # search the whole instance for "witches"		tea repo search witches # search the whole instance for "witches"
	tea repo create --name witchhub --init --private --gitignores go,node		tea repo create --name witchhub --init --private --gitignores go,node
			tea clone alice/witchub # = git clone
	tea repo fork alice/witchhub # fork to your account		tea repo fork alice/witchhub # fork to your account
	tea repo create-from-template -t alice/witchhub-template -n my-new-witchhub		tea repo create-from-template -t alice/witchhub-template -n my-new-witchhub

Rongzhou: /* Logging in */

2026-08-31T12:30:32Z

Logging in

← Older revision		Revision as of 12:30, 31 August 2026
Line 19:		Line 19:

	Run tea '''inside a clone''' and it reads <syntaxhighlight lang="bash" inline>owner/repo</syntaxhighlight> from the git remote — no flags needed. Otherwise point it at the target with <syntaxhighlight lang="bash" inline>--repo owner/name</syntaxhighlight> (or a local path), <syntaxhighlight lang="bash" inline>--remote name</syntaxhighlight>, and <syntaxhighlight lang="bash" inline>--login name</syntaxhighlight>.		Run tea '''inside a clone''' and it reads <syntaxhighlight lang="bash" inline>owner/repo</syntaxhighlight> from the git remote — no flags needed. Otherwise point it at the target with <syntaxhighlight lang="bash" inline>--repo owner/name</syntaxhighlight> (or a local path), <syntaxhighlight lang="bash" inline>--remote name</syntaxhighlight>, and <syntaxhighlight lang="bash" inline>--login name</syntaxhighlight>.

			== Installing <code>tea</code> ==

			On Linux,MacOS, the easiest installation is via Homebrew:

			<syntaxhighlight lang="bash" copy>
			brew install tea
			</syntaxhighlight>

			For more details on installation, see [https://gitea.com/gitea/tea#installation the official instructions].

			<blockquote>
			Do NOT install the "tea" in Debian repository. It is not the same cup of tea: it is a text editor porting the same name.
			</blockquote>

	== Logging in ==		== Logging in ==

Rongzhou: /* Repos */

2026-08-26T14:56:21Z

Repos

← Older revision		Revision as of 14:56, 26 August 2026
Line 97:		Line 97:
	<syntaxhighlight lang="bash" copy>		<syntaxhighlight lang="bash" copy>
	tea repo search witches # search the whole instance for "witches"		tea repo search witches # search the whole instance for "witches"
	tea repo create --name ~~widgets~~ --init --private --gitignores go,node		tea repo create --name witchhub --init --private --gitignores go,node
	tea repo fork alice/witchhub # fork to your account		tea repo fork alice/witchhub # fork to your account
	tea repo create-from-template -t alice/~~widgethub~~ -n my-~~clone~~		tea repo create-from-template -t alice/witchhub-template -n my-new-witchhub
	</syntaxhighlight>		</syntaxhighlight>

Rongzhou: /* Repos */

2026-08-26T14:55:22Z

Repos

← Older revision		Revision as of 14:55, 26 August 2026
Line 96:		Line 96:

	<syntaxhighlight lang="bash" copy>		<syntaxhighlight lang="bash" copy>
	tea repo search ~~widgets~~ # search the whole instance		tea repo search witches # search the whole instance for "witches"
	tea repo create --name widgets --init --private --gitignores go,node		tea repo create --name widgets --init --private --gitignores go,node
	tea repo fork alice/~~widgets~~ # fork to your account		tea repo fork alice/witchhub # fork to your account
	tea repo create-from-template -t alice/~~widgets~~ -n my-clone		tea repo create-from-template -t alice/widgethub -n my-clone
	</syntaxhighlight>		</syntaxhighlight>

Rongzhou at 14:51, 26 August 2026

2026-08-26T14:51:06Z

← Older revision		Revision as of 14:51, 26 August 2026
Line 1:		Line 1:
	{{Cheatsheet}}		{{Cheatsheet}}

	'''tea''' is the official command-line client for Gitea. ~~It speaks~~ the Gitea API, so it works against '''any compatible forge''' — Gitea itself, [https://forgejo.org/ Forgejo], and [https://codeberg.org/ Codeberg] (which runs Forgejo) — one tool for all ~~your forges~~.		'''tea''' is the official command-line client built for Gitea. Speaking the Gitea API, it works against '''any compatible forge''' — Gitea itself, [https://forgejo.org/ Forgejo], and [https://codeberg.org/ Codeberg] (which runs Forgejo) — one tool for all.

	New to tea? The [https://about.gitea.com/products/tea/ official tea page] and the [https://gitea.com/gitea/tea README] are good starts.		New to tea? The [https://about.gitea.com/products/tea/ official tea page] and the [https://gitea.com/gitea/tea README] are good starts.

RonzzWikiCowriterAI: Create tea CLI cheatsheet — AI-assisted (RonzzWikiCowriter) (via create-page on MediaWiki MCP Server)

2026-08-26T14:37:50Z

Create tea CLI cheatsheet — AI-assisted (RonzzWikiCowriter) (via create-page on MediaWiki MCP Server)

New page

{{Cheatsheet}}

'''tea''' is the official command-line client for Gitea. It speaks the Gitea API, so it works against '''any compatible forge''' — Gitea itself, [https://forgejo.org/ Forgejo], and [https://codeberg.org/ Codeberg] (which runs Forgejo) — one tool for all your forges.

New to tea? The [https://about.gitea.com/products/tea/ official tea page] and the [https://gitea.com/gitea/tea README] are good starts.

== Basic example: clone, open a PR, merge ==

<syntaxhighlight lang="bash" line copy>
tea login add # one-time: register a forge (interactive)
tea clone alice/widgets # clone owner/repo from your default login
cd widgets
git switch -c fix-header # ordinary git work
git push -u origin fix-header
tea pr create -b main -t "Fix header" -d "Make the header sticky"
tea pr checkout 42 # pull PR #42 into a local branch
tea pr merge 42 --style squash # merge it
</syntaxhighlight>

Run tea '''inside a clone''' and it reads <syntaxhighlight lang="bash" inline>owner/repo</syntaxhighlight> from the git remote — no flags needed. Otherwise point it at the target with <syntaxhighlight lang="bash" inline>--repo owner/name</syntaxhighlight> (or a local path), <syntaxhighlight lang="bash" inline>--remote name</syntaxhighlight>, and <syntaxhighlight lang="bash" inline>--login name</syntaxhighlight>.

== Logging in ==

Generate an application token in the forge's web UI (Settings → Applications), then:

<syntaxhighlight lang="bash" copy>
tea login add # interactive: "application token", paste token
tea login add -n work -u https://git.example.com -t $TOKEN # non-interactive
tea login add -n codeberg -u https://codeberg.org --oauth # browser OAuth2 flow
tea login ls # list your forges
tea login default # show the default login
tea whoami # who is the current login
tea logout # forget the current login
</syntaxhighlight>

Keep one login per forge — tea stores them all in <syntaxhighlight lang="text" inline>$XDG_CONFIG_HOME/tea/config.yml</syntaxhighlight> (usually <syntaxhighlight lang="text" inline>~/.config/tea/config.yml</syntaxhighlight>):

<syntaxhighlight lang="bash" copy>
tea login add -n gitea -u https://gitea.com -t $TOKEN_A
tea login add -n forgejo -u https://git.example.com -t $TOKEN_B
tea login add -n codeberg -u https://codeberg.org -t $TOKEN_C

tea pr list -l codeberg --repo alice/widgets # act on another forge
</syntaxhighlight>

<blockquote>
'''Authenticate plain git too:''' register a login with <syntaxhighlight lang="bash" inline>--git-credentials</syntaxhighlight>, and <syntaxhighlight lang="bash" inline>git push</syntaxhighlight> / <syntaxhighlight lang="bash" inline>git clone</syntaxhighlight> over HTTPS use the stored token without prompting.
</blockquote>

== Everyday: issues ==

<syntaxhighlight lang="bash" copy>
tea issues # open issues of the current repo
tea issues --state all # closed ones too
tea issues --assignee alice # only alice's
tea issues --keyword sticky # search
tea issue 42 # view issue #42
tea issue 42 --comments # ... with the comment thread
tea issue create -t "Header not sticky" -d "Steps…" -L bug -a alice
tea issue close 42 # close
tea issue reopen 42 # reopen
tea labels list # pick label names for -L
tea comment add 42 "Fixed in 0.9.1" # comment on an issue or PR
</syntaxhighlight>

== Everyday: pull requests ==

<syntaxhighlight lang="bash" copy>
tea pr list # open PRs of the current repo
tea pr list --state all -o table # everything, as a table
tea pr 42 # view PR #42
tea pr checkout 42 # local branch with the PR's commits
tea pr create -b main -t "Fix header" -d "Body" --draft
tea pr approve 42 # approve
tea pr reject 42 # request changes
tea pr merge 42 # merge (default: merge commit)
tea pr merge 42 --style squash # or: rebase, rebase-merge
tea pr close 42 # close without merging
tea pr clean 42 # drop the PR's local & remote branches
</syntaxhighlight>

<blockquote>
'''tea assumes your commits are already pushed.''' Push the branch before <syntaxhighlight lang="bash" inline>tea pr create</syntaxhighlight> or <syntaxhighlight lang="bash" inline>tea pr merge</syntaxhighlight>.
</blockquote>

== Releases ==

<syntaxhighlight lang="bash" copy>
tea releases # list releases
tea release create --tag v1.0.0 --title "v1.0.0" --note-file CHANGELOG.md
tea release create --tag v0.9.0 --prerelease -a app.tar.gz -a app.sha256
tea release delete v1.0.0 -y --delete-tag
</syntaxhighlight>

== Repos ==

<syntaxhighlight lang="bash" copy>
tea repo search widgets # search the whole instance
tea repo create --name widgets --init --private --gitignores go,node
tea repo fork alice/widgets # fork to your account
tea repo create-from-template -t alice/widgets -n my-clone
</syntaxhighlight>

== Notifications ==

<syntaxhighlight lang="bash" copy>
tea notifications # unread, current repo
tea notifications --mine # unread across all your repos
tea notifications read # mark as read
</syntaxhighlight>

== CI: Actions ==

<syntaxhighlight lang="bash" copy>
tea actions runs list # recent workflow runs
tea actions runs logs 1234 --follow # stream logs of a run
tea actions workflows dispatch deploy.yml --ref main --input env=staging
tea actions secrets create API_KEY # prompts for the value
tea actions variables set API_URL https://api.example.com
</syntaxhighlight>

== Scripting & output ==

<syntaxhighlight lang="bash" copy>
tea pr list -o json # formats: json | yaml | table | csv | tsv | simple
tea issues --state open --limit 100 -o csv
tea api /repos/alice/widgets/issues # any authenticated API call (-X, -d, -H, -f)
</syntaxhighlight>

== For more ==

* [https://gitea.com/gitea/tea README] — install options (brew, dl.gitea.com, go install) and quickstart
* [https://gitea.com/gitea/tea/src/branch/main/docs/CLI.md CLI reference] — auto-generated docs for every command and flag
* [https://about.gitea.com/products/tea/ Official tea page]
* Shell completion: <syntaxhighlight lang="bash" inline>source <(tea completion bash)</syntaxhighlight> (zsh, fish, PowerShell also supported); <syntaxhighlight lang="bash" inline>tea man</syntaxhighlight> prints the man page
* [[Cheatsheets:Git]] — the git that does the heavy lifting