Installation#

tgs ships as a single static binary with no runtime dependencies. Pick whichever method fits your platform — the installed command is always tgs.

Homebrew (macOS & Linux)#

The quickest way on macOS and Linux:

brew install garenal1v3/tap/tgs-cli

This installs the tgs binary and keeps it up to date via brew upgrade.

Prebuilt binaries#

Grab a release archive for your platform from the releases page. Archives are named tgs-cli_<os>_<arch>:

Platform	OS	Arch
macOS (Apple Silicon)	`darwin`	`arm64`
macOS (Intel)	`darwin`	`amd64`
Linux	`linux`	`amd64` / `arm64`
Windows	`windows`	`amd64` / `arm64`

macOS & Linux#

# Choose your platform: OS = darwin (macOS) or linux; ARCH = arm64 or amd64
OS=darwin
ARCH=arm64

curl -L -o tgs.tar.gz \
  "https://github.com/garenal1v3/tgs-cli/releases/latest/download/tgs-cli_${OS}_${ARCH}.tar.gz"
tar -xzf tgs.tar.gz tgs
sudo mv tgs /usr/local/bin/
tgs version

Windows#

# PowerShell — ARCH = amd64 or arm64
$Arch = "amd64"
Invoke-WebRequest `
  -Uri "https://github.com/garenal1v3/tgs-cli/releases/latest/download/tgs-cli_windows_$Arch.zip" `
  -OutFile tgs.zip
Expand-Archive tgs.zip -DestinationPath .
# Move tgs.exe into a directory on your PATH, then:
.\tgs.exe version

Build from source#

Requires Go 1.26 or newer:

git clone https://github.com/garenal1v3/tgs-cli.git
cd tgs-cli
make build       # produces ./tgs in the repo root
# or install into $GOBIN / $GOPATH/bin:
make install

Verifying the install#

tgs version

You should see a JSON object with the version, commit, and build date. Next, head to Quick Start.