A command line tool to interact with Gitea servers
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
6543 2653eaa6b2
2 years ago
cmd add `tea issues [open|close]` commands (#99) 2 years ago
modules add `tea pulls [checkout | clean]` commands (#93 #97 #107) (#105) 2 years ago
vendor add `tea pulls [checkout | clean]` commands (#93 #97 #107) (#105) 2 years ago
.changelog.yml Add missing Changelog for 0.1.x releases (#91) 2 years ago
.drone.yml Fix CI: Turn off go modules for xgo and gxz (#115) 2 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) 3 years ago
CHANGELOG.md v0.3.0 2 years ago
CONTRIBUTING.md init project 4 years ago
DCO init project 4 years ago
LICENSE init project 4 years ago
Makefile Fix CI: Turn off go modules for xgo and gxz (#115) 2 years ago
README.md README: add badges (#80) 3 years ago
go.mod add `tea pulls [checkout | clean]` commands (#93 #97 #107) (#105) 2 years ago
go.sum ignore PRs in runIssuesList() (#111) 2 years ago
main.go v0.3.0 2 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.