gt

gt – Gitea CLI

gt is a fast, minimal command-line tool to work with a self-hosted Gitea instance: repositories, issues, pull requests and more.

$ gt repo list
NAME                     DESCRIPTION            PRIVATE   FORK
cryptexctl/infra         Infrastructure code    yes       no
cryptexctl/teah          Gitea CLI              no        no

Installation

From source

git clone https://github.com/cryptexctl/gt
cd teah-cli
make build      # binary in bin/gt
sudo make install  # optional, copies to /usr/local/bin

Golang

go install github.com/cryptexctl/gt@latest

Quick start

# Configure credentials (stores in ~/.config/gt/config.yaml)
gt auth login --host https://git.example.com --token YOUR_TOKEN

# List own repositories
gt repo list

# Create repository
gt repo create my-project --description "Demo project" --private

# Issues
gt issue list owner/project

# Pull requests
gt pr create owner/project --title "Fix bug" --head fix/bug --base main

Commands overview

Run gt <command> --help for sub-commands and flags.

Configuration

• default path: ~/.config/gt/config.yaml
• env variables override values:
  • GT_HOST
  • GT_TOKEN

Contributing

1. Fork and clone the repo.
2. make dev – build & run in watch mode.
3. Send pull request.

[*] Keep code straightforward, comments minimal.

License

0BSD © Lain