Files
docs/cli-docs/index.md
T
silverwindandClaude 8594d73ccd docs: tighten the gt guides and the cli wiring
The workflow example had no trigger, so Gitea would reject it as written.
The guides now merge the small account sections and point users at the
nightly builds they describe. Comments and READMEs no longer mention the
dropped reference generator or list the runner as the only hand written
sidebar product, and the sidebar lookup drops a key the fallback covers.

Co-Authored-By: Claude (Opus 5.5) <[email protected]>
2026-10-22 22:06:45 +02:00

1018 B

sidebar_position, slug
sidebar_position slug
1 /

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.

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