Renovate Bot a010c9bc7f
Some checks failed
goreleaser / release-image (push) Has been cancelled
goreleaser / goreleaser (push) Has been cancelled
chore(deps): update ghcr.io/devcontainers/features/git-lfs docker tag to v1.2.5 (#773)
Reviewed-on: #773 Co-authored-by: Renovate Bot <renovate-bot@gitea.com> Co-committed-by: Renovate Bot <renovate-bot@gitea.com>
2025-07-21 21:22:04 +00:00
2025-06-16 19:23:55 +00:00
2025-06-10 05:19:59 +00:00
2023-10-23 18:36:38 +00:00
2020-12-14 20:33:54 +08:00
2025-02-27 18:33:37 +00:00
2025-02-27 18:33:37 +00:00
2024-04-08 16:37:08 +00:00
2023-09-08 01:40:02 +00:00
2023-02-15 23:23:12 +01:00
2023-09-08 01:40:02 +00:00
2018-09-03 14:43:00 +08:00
2024-12-27 02:00:57 +00:00
2025-02-27 18:33:37 +00:00
2025-02-27 18:33:37 +00:00
2025-06-10 05:19:59 +00:00
2025-06-10 05:19:59 +00:00
2025-07-21 21:21:25 +00:00
2023-09-07 23:08:07 +00:00

tea logo T E A

License: MIT Release Join the chat at https://img.shields.io/discord/322538954119184384.svg Go Report Card GoDoc Tea Release Status

The official CLI for Gitea

demo gif

 tea - command line tool to interact with Gitea version 0.8.0-preview USAGE tea command [subcommand] [command options] [arguments...] DESCRIPTION tea is a productivity helper for Gitea. It can be used to manage most entities on one or multiple Gitea instances & provides local helpers like 'tea pr checkout'. tea tries to make use of context provided by the repository in $PWD if available. tea works best in a upstream/fork workflow, when the local main branch tracks the upstream repo. tea assumes that local git state is published on the remote before doing operations with tea. Configuration is persisted in $XDG_CONFIG_HOME/tea. COMMANDS help, h Shows a list of commands or help for one command ENTITIES: issues, issue, i List, create and update issues pulls, pull, pr Manage and checkout pull requests labels, label Manage issue labels milestones, milestone, ms List and create milestones releases, release, r Manage releases release assets, release asset, r a Manage release attachments times, time, t Operate on tracked times of a repository's issues & pulls organizations, organization, org List, create, delete organizations repos, repo Show repository details comment, c Add a comment to an issue / pr HELPERS: open, o Open something of the repository in web browser notifications, notification, n Show notifications clone, C Clone a repository locally SETUP: logins, login Log in to a Gitea server logout Log out from a Gitea server shellcompletion, autocomplete Install shell completion for tea whoami Show current logged in user OPTIONS --help, -h show help (default: false) --version, -v print the version (default: false) EXAMPLES tea login add # add a login once to get started tea pulls # list open pulls for the repo in $PWD tea pulls --repo $HOME/foo # list open pulls for the repo in $HOME/foo tea pulls --remote upstream # list open pulls for the repo pointed at by # your local "upstream" git remote # list open pulls for any gitea repo at the given login instance tea pulls --repo gitea/tea --login gitea.com tea milestone issues 0.7.0 # view open issues for milestone '0.7.0' tea issue 189 # view contents of issue 189 tea open 189 # open web ui for issue 189 tea open milestones # open web ui for milestones # send gitea desktop notifications every 5 minutes (bash + libnotify) while :; do tea notifications --mine -o simple | xargs -i notify-send {}; sleep 300; done ABOUT Written & maintained by The Gitea Authors. If you find a bug or want to contribute, we'll welcome you at https://gitea.com/gitea/tea. More info about Gitea itself on https://about.gitea.com. 

Installation

There are different ways to get tea:

  1. Install via your system package manager:

    • macOS via brew (official):
      brew install tea 
    • arch linux (tea, thirdparty)
    • alpine linux (tea, thirdparty)
    • Windows via MSYS2 (tea, thirdparty)
  2. Use the prebuilt binaries from dl.gitea.com

  3. Install from source: see Compilation

  4. Docker (thirdparty): tgerczei/tea

  5. asdf (thirdparty): mvaldes14/asdf-tea

Compilation

Make sure you have a current go version installed (1.13 or newer).

  • To compile the source yourself with the recommended flags & tags:

    git clone https://gitea.com/gitea/tea.git # or: tea clone gitea.com/gitea/tea ;) cd tea make 

    Note that GNU Make (gmake on OpenBSD) is required. If you want to install the compiled program you have to execute the following command:

    make install 

    This installs the binary into the "bin" folder inside of your GOPATH folder (go env GOPATH). It is possible that this folder isn't in your PATH Environment Variable.

  • For a quick installation without git & make, set $version and exec:

    go install code.gitea.io/tea@${version} 

Contributing

Fork -> Patch -> Push -> Pull Request

  • make test run testsuite
  • make vet run checks (check the order of imports; preventing failure on CI pipeline beforehand)
  • ... (for other development tasks, check the Makefile)

Please read the CONTRIBUTING documentation, it will tell you about internal structures and concepts.

License

This project is under the MIT License. See the LICENSE file for the full license text.

Description
A command line tool to interact with Gitea servers
Readme MIT 71 MiB
v0.11.1 Latest
2025-10-17 23:16:01 +00:00
Languages
Go 98.7%
Makefile 0.7%
Shell 0.2%
Nix 0.2%