# Install tea with Homebrew, apk, apt, MacPorts, Nix, pacman, zypper, scoop, winget

Command-line tool to interact with Gitea servers. Version 0.15.1 via Homebrew; verified 2026-08-02. Also installable with debian: sudo apt install tea.

## Install

```sh
sudo av install brew:tea
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install tea
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install tea
```

  Evidence: MacPorts ports tree: editors/tea/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add tea
```

  Evidence: Alpine Linux edge package indexes: tea from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install tea
```

  Evidence: Debian stable package indexes: tea from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#tea
```

  Evidence: nixpkgs package indexes: pkgs/by-name/te/tea/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S tea
```

  Evidence: Arch Linux sync databases: tea from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install tea
```

  Evidence: openSUSE Tumbleweed package metadata: tea from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/tea
```

  Evidence: Scoop official bucket manifest trees: bucket/tea.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id Gitea.tea -e
```

  Evidence: Windows Package Manager source index: Gitea.tea from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:tea
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/tea>
- **Version:** 0.15.1
- **Source summary:** Command-line tool to interact with Gitea servers
- **Homepage:** <https://gitea.com/gitea/tea>
- **Upstream docs:** <https://gitea.com/gitea/tea>
- **License:** MIT
- **Source archive:** <https://gitea.com/gitea/tea/archive/v0.15.1.tar.gz>
- **Last updated:** 2026-08-02T16:04:56Z
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- tea (cli)
- tea (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 0.15.1
- Package-manager updated: 2026-08-02
- Local data: ok
- Upstream repository: https://gitea.com/gitea/tea
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Tea is the official command-line interface for Gitea. It gives Gitea users a terminal workflow for issues, pull requests, labels, milestones, releases, repositories, notifications, actions, webhooks, and administrative tasks.

### Project history

The official Gitea repository metadata shows `gitea/tea` was created in 2019. Its README presents Tea as a productivity helper for Gitea that uses the `gitea.dev/sdk` client library and interacts with the Gitea API.

Tea developed around repository-context-aware workflows: the README says it tries to use the repository in the current working directory, works well in upstream/fork workflows, and includes local helpers such as `tea pr checkout`.

### Adoption history

The official README lists Homebrew as the official macOS package route, prebuilt binaries from dl.gitea.com, source installation, and Docker. The supplied package-manager facts show Tea packaged across Homebrew, Debian/Ubuntu, Alpine, Arch, MacPorts, Nix, Scoop, winget, and openSUSE.

### How it is used

Tea is used by Gitea users who want GitHub-CLI-like operations against one or more Gitea instances. It supports login management, pull request checkout, issue viewing and commenting, release management, repository cloning, notification polling, and Gitea Actions secrets and variables.

### Why package nerds care

Tea matters in the package-nerd niche because it is the canonical CLI for a self-hostable forge. Packagers care about it both as an end-user binary and as part of the wider Gitea ecosystem, especially where distributions support users who run private Gitea instances.

### Timeline

- 2019: Official Gitea Tea repository created.
- 2023: v0.9.x releases published on gitea.com.
- 2026: v0.14.x releases published, showing ongoing maintenance.

### Related projects

- Tea is tied directly to Gitea and uses gitea.dev/sdk to interact with the Gitea API.

### Sources

- <https://gitea.com/api/v1/repos/gitea/tea>
- <https://gitea.com/api/v1/repos/gitea/tea/releases>
- <https://gitea.com/gitea/tea>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for tea. Package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: $XDG_CONFIG_HOME/tea

## Credential files

- Unix: $XDG_CONFIG_HOME/tea
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** tea
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - tea - 63.3.0-1: normalized package name match | Debian stable package indexes: tea from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | graphical text editor with syntax highlighting | https://tea.ourproject.org/
- Debian apt - tea-data - 63.3.0-1: normalized package name match | Debian stable package indexes: tea-data from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | graphical text editor with syntax highlighting - data files | https://tea.ourproject.org/
- Nix - tea: normalized package name match | nixpkgs package indexes: pkgs/by-name/te/tea/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - tea - 62.0.2-1build3: normalized package name match | Ubuntu 24.04 LTS package indexes: tea from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | graphical text editor with syntax highlighting | https://tea.ourproject.org/
- Ubuntu apt - tea-data - 62.0.2-1build3: normalized package name match | Ubuntu 24.04 LTS package indexes: tea-data from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | graphical text editor with syntax highlighting - data files | https://tea.ourproject.org/
- apk - tea - 0.14.2-r0: normalized package name match | Alpine Linux edge package indexes: tea from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A command line tool to interact with Gitea servers | https://gitea.com/gitea/tea
- apk - tea-bash-completion - 0.14.2-r0: normalized package name match | Alpine Linux edge package indexes: tea-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for tea | https://gitea.com/gitea/tea
- pacman - tea - 0.15.0-1: normalized package name match | Arch Linux sync databases: tea from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A command line tool to interact with Gitea servers | https://gitea.com/gitea/tea
- zypper - tea - 61.2.0-2.6: normalized package name match | openSUSE Tumbleweed package metadata: tea from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Qt-based text editor with image viewer | http://semiletov.org/tea
- MacPorts - tea: normalized package name match | MacPorts ports tree: editors/tea/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/tea: normalized package name match | Scoop official bucket manifest trees: bucket/tea.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - Gitea.tea: normalized package name match | Windows Package Manager source index: Gitea.tea from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://pkg.so/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://pkg.so/brew/go/) - Build dependency declared by Homebrew.
- [git-spice](https://pkg.so/brew/git-spice/) - Shares pkgdb curated category or tags: cli, developer-tools, git, pull-requests.
- [multi-gitter](https://pkg.so/brew/multi-gitter/) - Shares pkgdb curated category or tags: cli, developer-tools, git, pull-requests.
- [gh](https://pkg.so/brew/gh/) - Shares pkgdb curated category or tags: cli, developer-tools, git.
- [libgit2](https://pkg.so/brew/libgit2/) - Shares pkgdb curated category or tags: cli, developer-tools, git.
- [glab](https://pkg.so/brew/glab/) - Shares pkgdb curated category or tags: cli, developer-tools, git.
- [git-lfs](https://pkg.so/brew/git-lfs/) - Shares pkgdb curated category or tags: cli, developer-tools, git.
- [lazygit](https://pkg.so/brew/lazygit/) - Shares pkgdb curated category or tags: cli, developer-tools, git.
- [bat](https://pkg.so/brew/bat/) - Shares pkgdb curated category or tags: cli, developer-tools, git.
- [gitea-runner](https://pkg.so/brew/gitea-runner/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, gitea.

## Combined YAML source

View the package source record on GitHub. [combined/tea.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tea.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
