A command line tool to interact with Gitea servers
Go to file
Norwin f5d0790619 Add --state flag filter to issue & PR lists (#100)
Add --state flag filter to issue & PR lists

Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: Norwin Roosen <git@nroo.de>
Reviewed-on: gitea/tea#100
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com>
Reviewed-by: Andrew Thornton <art27@cantab.net>
Reviewed-by: 6543 <6543@noreply.gitea.io>
2020-03-29 13:16:06 +00:00
cmd Add --state flag filter to issue & PR lists (#100) 2020-03-29 13:16:06 +00:00
modules Add Makefile / .drone.yml, use go module with vendor (#20) 2019-04-25 20:06:53 +03:00
vendor add `tea times` command (#54) 2020-03-06 03:43:28 +00:00
.changelog.yml Add missing Changelog for 0.1.x releases (#91) 2020-01-31 02:24:57 +00:00
.drone.yml Fix CI for releasing tea (#106) 2020-03-08 01:29:46 +00:00
.gitignore add repos subcommand [continue #44] (#3) (#65) 2019-11-08 01:33:46 +00:00
.revive.toml Add Makefile / .drone.yml, use go module with vendor (#20) 2019-04-25 20:06:53 +03:00
CHANGELOG.md Changelog v0.2.0 (#102) 2020-03-07 01:24:51 +00:00
CONTRIBUTING.md init project 2018-09-03 14:43:00 +08:00
DCO init project 2018-09-03 14:43:00 +08:00
LICENSE init project 2018-09-03 14:43:00 +08:00
Makefile Improve makefile to enable goproxy when go get tools. (#98) 2020-03-05 09:22:41 +00:00
README.md README: add badges (#80) 2020-01-03 00:58:45 +00:00
go.mod add `tea times` command (#54) 2020-03-06 03:43:28 +00:00
go.sum add `tea times` command (#54) 2020-03-06 03:43:28 +00:00
main.go add `tea times` command (#54) 2020-03-06 03:43:28 +00:00

Gitea Command Line Tool for Go

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

This project acts as a command line tool for operating one or multiple Gitea instances. It depends on code.gitea.io/sdk client SDK implementation written in Go to interact with the Gitea API implementation.


Currently no prebuilt binaries are provided. To install, a Go installation is needed.

go get code.gitea.io/tea
go install code.gitea.io/tea

If the tea executable is not found, you might need to set up your $GOPATH and $PATH variables first:

export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

If you have brew installed, you can install tea version via:

brew tap gitea/tap https://gitea.com/gitea/homebrew-gitea
brew install --devel tea


First of all, you have to create a token on your personal settings -> application page of your gitea instance. Use this token to login with tea:

tea login add --name=try --url=https://try.gitea.io --token=xxxxxx

Now you can use the tea commands:

tea issues
tea releases

To fetch issues from different repos, use the --remote flag (when inside a gitea repository directory) or --login & --repo flags.


To compile the sources yourself run the following:

go get code.gitea.io/tea
cd "${GOPATH}/src/code.gitea.io/tea"
go build


Fork -> Patch -> Push -> Pull Request

  • make test run testsuite
  • make vendor when adding new dependencies
  • ... (for other development tasks, check the Makefile)



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