mirror of
https://gitea.com/gitea/docs.git
synced 2026-11-05 17:45:46 +00:00
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]>
39 lines
1018 B
Markdown
39 lines
1018 B
Markdown
---
|
|
sidebar_position: 1
|
|
slug: /
|
|
---
|
|
|
|
# Gitea CLI
|
|
|
|
[gt](https://gitea.com/gitea/cli) 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](installation.md).
|
|
2. [Log in](authentication.md):
|
|
|
|
```bash
|
|
gt auth login
|
|
```
|
|
|
|
3. Run commands in a clone of a repository on that instance, or select one with `--repo`:
|
|
|
|
```bash
|
|
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.
|