Fork 0
Go to file
Martin Reboredo 43e9943757 Add interactive mode for `tea milestone create` (#310)
Implement interactive milestone creation

Return fmt.Errorf when title is empty

Incorporate deadline functionality

Use dateparse and cleanup CreateMilestone task

Signed-off-by: Martin Reboredo <yakoyoku@gmail.com>
Co-authored-by: Martin Reboredo <yakoyoku@gmail.com>
Reviewed-on: https://gitea.com/gitea/tea/pulls/310
Reviewed-by: Norwin <noerw@noreply.gitea.io>
Reviewed-by: 6543 <6543@obermui.de>
Co-Authored-By: Martin Reboredo <yakoyakoyokuyoku@noreply.gitea.io>
Co-Committed-By: Martin Reboredo <yakoyakoyokuyoku@noreply.gitea.io>
2020-12-18 02:50:07 +08:00
cmd Add interactive mode for `tea milestone create` (#310) 2020-12-18 02:50:07 +08:00
contrib Add command to install shell completion (#309) 2020-12-17 00:01:59 +08:00
modules Add interactive mode for `tea milestone create` (#310) 2020-12-18 02:50:07 +08:00
vendor Release delete: add --delete-tag & --confirm (#286) 2020-12-10 05:51:07 +08:00
.changelog.yml Changelog v0.6.0 (#289) 2020-12-14 20:33:54 +08:00
.drone.yml Use gox to cross-compile (#274) 2020-12-09 01:45:48 +08:00
.gitignore Add interactive mode for `tea milestone create` (#310) 2020-12-18 02:50:07 +08: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.6.0 (#289) 2020-12-14 20:33:54 +08:00
CONTRIBUTING.md Update Docu to new Structure (#247) 2020-10-25 07:48:20 +08:00
DCO init project 2018-09-03 14:43:00 +08:00
FEATURE-COMPARISON.md Add feature comparison chart between forge CLIs (#294) 2020-12-15 12:59:49 +08:00
LICENSE init project 2018-09-03 14:43:00 +08:00
Makefile make install: use vendor dir (#292) 2020-12-13 02:08:10 +08:00
README.md Add command to install shell completion (#309) 2020-12-17 00:01:59 +08:00
build.go Update gitea-vet v0.2.0 (#164) 2020-07-21 16:17:52 +00:00
go.mod Release delete: add --delete-tag & --confirm (#286) 2020-12-10 05:51:07 +08:00
go.sum Release delete: add --delete-tag & --confirm (#286) 2020-12-10 05:51:07 +08:00
main.go Refactor error handling (#308) 2020-12-17 00:18:10 +08:00



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

For a feature comparison with other git forge CLIs see here.


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

To install from source, go 1.13 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)

Shell completion can be added via tea autocomplete --install.


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, create, checkout and clean pull requests
releases         List, create, update and delete 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
notifications    Show notifications
milestones       List and create milestones
organizations    List, create, delete organizations
help, h          Shows a list of commands or help for one command

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 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.