A command line tool to interact with Gitea servers
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Norwin ac25e89ebf
Add `tea repo create-from-template` (#408)
1 year ago
cmd Add `tea repo create-from-template` (#408) 1 year ago
contrib Add command to install shell completion (#309) 2 years ago
modules Add `tea clone` (#411) 1 year ago
vendor Show issue reactions (#421) 1 year ago
.changelog.yml Changelog v0.6.0 (#289) 2 years ago
.dockerignore Makefile: add STATIC=true for static PIE builds (#349) 1 year ago
.drone.yml fix CI release upload: switch to woodpecker/plugin-s3 (#428) 1 year ago
.gitignore Add interactive mode for `tea milestone create` (#310) 2 years ago
.revive.toml Add Makefile / .drone.yml, use go module with vendor (#20) 4 years ago
CHANGELOG.md Changelog v0.8.0 (#404) 1 year ago
CONTRIBUTING.md Update Docu to new Structure (#247) 2 years ago
DCO init project 4 years ago
Dockerfile Makefile: add STATIC=true for static PIE builds (#349) 1 year ago
FEATURE-COMPARISON.md Add feature comparison chart between forge CLIs (#294) 2 years ago
LICENSE init project 4 years ago
Makefile Makefile: add STATIC=true for static PIE builds (#349) 1 year ago
README.md Fix notification example (#416) 1 year ago
build.go Update gitea-vet v0.2.0 (#164) 3 years ago
demo.gif Proper help text & new README structure (#311) 2 years ago
go.mod Show issue reactions (#421) 1 year ago
go.sum Show issue reactions (#421) 1 year ago
main.go Add `tea clone` (#411) 1 year ago



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

The official CLI for Gitea

demo gif

   tea - command line tool to interact with Gitea
   version 0.7.0-preview

   tea command [subcommand] [command options] [arguments...]

   tea is a productivity helper for Gitea.  It can be used to manage most entities on one
   or multiple Gitea instances and provides local helpers like 'tea pull checkout'.
   tea makes use of context provided by the repository in $PWD if available, but is still
   usable independently of $PWD. Configuration is persisted in $XDG_CONFIG_HOME/tea.

   help, h  Shows a list of commands or help for one command
     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
     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
     open, o                         Open something of the repository in web browser
     notifications, notification, n  Show notifications
     logins, login                  Log in to a Gitea server
     logout                         Log out from a Gitea server
     shellcompletion, autocomplete  Install shell completion for tea

   --help, -h     show help (default: false)
   --version, -v  print the version (default: false)

   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

   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://gitea.io.


There are different ways to get tea:

  1. Install via your system package manager:

    • macOS via brew (gitea-maintained):
      brew tap gitea/tap https://gitea.com/gitea/homebrew-gitea
      brew install tea
    • arch linux (gitea-tea, thirdparty)
    • alpine linux (tea, thirdparty)
  2. Use the prebuilt binaries from dl.gitea.io

  3. Install from source (go 1.13 or newer is required):

    go get code.gitea.io/tea
    go install code.gitea.io/tea
  4. Docker (thirdparty): tgerczei/tea


Make sure you have installed a current go version. To compile the sources yourself run the following:

git clone https://gitea.com/gitea/tea.git
cd tea
make STATIC=true


Fork -> Patch -> Push -> Pull Request

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

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


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