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 66947bcf09 Update Vendors (#145) 1 day ago
cmd --ssh-key should be string not bool (#135) 1 month ago
modules migrate src-d/go-git -> go-git/go-git (#128) 2 months ago
vendor Update Vendors (#145) 1 day ago
.changelog.yml Add missing Changelog for 0.1.x releases (#91) 5 months ago
.drone.yml Fix CI: Turn off go modules for xgo and gxz (#115) 3 months ago
.gitignore Add gitea-vet (#121) 2 months ago
.revive.toml Add Makefile / .drone.yml, use go module with vendor (#20) 1 year ago
CHANGELOG.md Add Changelog for v0.3.1 (#139) (#140) 4 weeks ago
CONTRIBUTING.md init project 1 year ago
DCO init project 1 year ago
LICENSE init project 1 year ago
Makefile Add gitea-vet (#121) 2 months ago
README.md Add note for alpine/arch-linux package (#143) 1 week ago
build.go Add gitea-vet (#121) 2 months ago
go.mod Update Vendors (#145) 1 day ago
go.sum Update Vendors (#145) 1 day ago
main.go Changelog for v0.3.0 (#122) 2 months ago



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

The official CLI interface for gitea

Tea is a command line tool for interacting on one or more Gitea instances. It uses code.gitea.io/sdk and interacts with the Gitea API

demo gif


You can use the prebuilt binaries from dl.gitea.io

To install from source, go 1.12 or newer is required:

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

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

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

Distribution packages exist for: alpinelinux (tea) and archlinux (gitea-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 following tea subcommands. Detailed usage information is available via tea <command> --help.

login            Log in to a Gitea server
logout           Log out from a Gitea server
issues           List, create and update issues
pulls            List, checkout and clean pull requests
releases         Create releases
repos            Operate with repositories
labels           Manage issue labels
times            Operate on tracked times of a repositorys issues and pulls
open             Open something of the repository on web browser

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


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


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.