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 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>
3 years ago
cmd Add --state flag filter to issue & PR lists (#100) 3 years ago
modules Add Makefile / .drone.yml, use go module with vendor (#20) 4 years ago
vendor add `tea times` command (#54) 3 years ago
.changelog.yml Add missing Changelog for 0.1.x releases (#91) 3 years ago
.drone.yml Fix CI for releasing tea (#106) 3 years ago
.gitignore add repos subcommand [continue #44] (#3) (#65) 3 years ago
.revive.toml Add Makefile / .drone.yml, use go module with vendor (#20) 4 years ago
CHANGELOG.md Changelog v0.2.0 (#102) 3 years ago
CONTRIBUTING.md init project 5 years ago
DCO init project 5 years ago
LICENSE init project 5 years ago
Makefile Improve makefile to enable goproxy when go get tools. (#98) 3 years ago
README.md README: add badges (#80) 3 years ago
go.mod add `tea times` command (#54) 3 years ago
go.sum add `tea times` command (#54) 3 years ago
main.go add `tea times` command (#54) 3 years ago


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.