Gitea CLI

gt is the official command line client for Gitea. It works with repositories, issues, pull requests, releases, Actions and the other resources of a Gitea instance, from a terminal or a script.

Development version

These pages describe builds from the main branch, published as nightly binaries and images.

gt needs Gitea 28 or later, and Git for the commands that clone, check out or push.

Getting started

1. Install gt.

2. Log in:

   gt auth login

3. Run commands in a clone of a repository on that instance, or select one with --repo:

   gt issue list --label bug
   gt pr checkout 13
   gt issue view 42 --repo gitea.com/gitea/cli

gt doctor checks your setup and suggests a fix for each problem it finds.

gt <command> --help lists the flags of a command, and gt help environment the global flags and environment variables.