GTT CLI | GTT-Method

GTT CLI is a single binary (gtt) for Linux, macOS and Windows (x86_64 and arm64). Every method installs the same binary from the latest published release at https://github.com/GTT-Community/gtt-cli/releases/latest and verifies its SHA-256 checksum.

Install GTT CLI

Linux and macOS (curl)

curl -fsSL https://raw.githubusercontent.com/GTT-Community/gtt-cli/main/install.sh | sh

Windows (PowerShell)

irm https://raw.githubusercontent.com/GTT-Community/gtt-cli/main/install.ps1 | iex

uv (Python)

uv tool install gtt-cli

npm (Node.js 18+)

npm install -g gtt-cli

Go 1.27+

go install github.com/GTT-Community/gtt-cli/cmd/gtt@latest

Verify the installation

gtt version

Try it without installing

uvx --from gtt-cli gtt version
npx gtt-cli version

Update

curl / PowerShell

Run the same install command again.

uv

uv tool upgrade gtt-cli

npm

npm update -g gtt-cli

Install a specific version (example: 1.0.1)

curl

curl -fsSL https://raw.githubusercontent.com/GTT-Community/gtt-cli/main/install.sh | GTT_VERSION=1.0.1 sh

PowerShell

$env:GTT_VERSION="1.0.1"; irm https://raw.githubusercontent.com/GTT-Community/gtt-cli/main/install.ps1 | iex

uv

uv tool install gtt-cli==1.0.1

npm

npm install -g gtt-cli@1.0.1

Where it is installed (curl and PowerShell)

Linux/macOS: /usr/local/bin if it is writable; otherwise ~/.local/bin (change it with GTT_INSTALL_DIR)
Windows: %LOCALAPPDATA%\Programs\gtt, which is added to the user PATH (open a new terminal)

Requirements

GTT CLI needs nothing else to run, but GTT Bootstrap (which the CLI downloads and operates) uses:

git
bash and python3
On Windows: Git for Windows (provides bash) and Python 3

On Windows the CLI uses Git Bash automatically and never the WSL bash. To use a different bash, set GTT_BASH to the path of bash.exe.

Manual download

Per-platform files are available at https://github.com/GTT-Community/gtt-cli/releases/latest

gtt_linux_amd64.tar.gz, gtt_linux_arm64.tar.gz
gtt_darwin_amd64.tar.gz (macOS Intel), gtt_darwin_arm64.tar.gz (macOS Apple Silicon)
gtt_windows_amd64.zip, gtt_windows_arm64.zip
checksums.txt (SHA-256)

First use

cd my-project
gtt init
gtt status

Source code and documentation: https://github.com/GTT-Community/gtt-cli