A lightweight command-line tool to fetch release information, list binary assets, and download from any GitHub project — without authentication.

curl -fsSL https://cdn.sylvain.sh/bash/gft@latest/install.sh | sh

# Download and run the installer
./install.sh

# Or manually:
cp gft /usr/local/bin/
chmod +x /usr/local/bin/gft

gft <user/repo> [tag] [options]

# Get latest release info
gft cli/cli

# Get a specific version
gft nodejs/node v22.0.0

# List all binary assets
gft cli/cli --assets

# Auto-detect the right binary for your OS
gft cli/cli --detect

# Download a specific asset
gft cli/cli --get "linux-amd64.deb"

# Get just the version number (for scripts)
VERSION=$(gft nodejs/node -q)

# Show release notes
gft cli/cli --notes

# JSON output
gft cli/cli --json

# Compare two releases
gft cli/cli v2.40.0..v2.50.0

gfv is available as an alias for gft.

• Automatic latest release detection
• Binary asset listing (--assets)
• Platform auto-detection (--detect) — finds the right binary for your OS/arch
• Direct asset download by pattern (--get)
• Release notes display (--notes)
• JSON output for scripting (--json)
• Quiet mode — just the version string (-q)
• Version comparison (v1.0..v2.0)
• Self-update check (--check-update)
• Works without GitHub authentication
• Transparent gh CLI fallback for private repos (when available)
• Respects NO_COLOR convention and pipe detection
• Bash and Zsh completion

gft scrapes GitHub release pages directly, so it:

• Requires no authentication (no token setup)
• Has no API rate limit issues (scraping, not API)
• Works on any machine with curl and bash

When gh CLI is installed and authenticated, gft uses it transparently as a fallback for private repositories and richer JSON output.

→ Looking up user/repo (latest)...

✓ Latest release: vX.Y.Z

- Repository:  user/repo
- Tag:         vX.Y.Z

> Links
  ├─ Repository:   https://github.com/user/repo
  ├─ Releases:     https://github.com/user/repo/releases
  └─ This release: https://github.com/user/repo/releases/tag/vX.Y.Z

> Source Archives
  ├─ ZIP:    https://github.com/user/repo/archive/refs/tags/vX.Y.Z.zip
  └─ TAR.GZ: https://github.com/user/repo/archive/refs/tags/vX.Y.Z.tar.gz

> Quick Commands
  ├─ curl -LO "https://github.com/user/repo/archive/refs/tags/vX.Y.Z.zip"
  ├─ curl -LO "https://github.com/user/repo/archive/refs/tags/vX.Y.Z.tar.gz"
  └─ git clone --depth 1 --branch vX.Y.Z https://github.com/user/repo.git

→ Download? (z)ip, (t)ar.gz, (n)o [n]:

• curl (for HTTP requests)
• bash (>= 4.0)
• Internet connection
• Optional: gh CLI for private repos and richer data

• Check the spelling of username and repository
• Make sure the repository is public (or use gh auth login for private repos)

• The repository may not have any releases
• Visit https://github.com/username/repository/releases to verify

• Check your internet connection
• The specified tag may not exist