Getting Started

gtl is a Go CLI for Git and GitHub productivity. It is designed for common local repo, branch, pull request, worktree, and maintenance workflows.

Install From Source

git clone https://github.com/anduimagui/gittles.git
cd gittles
go build -o gtl .
cp gtl "$(go env GOPATH)/bin/"

This puts gtl on your PATH when $(go env GOPATH)/bin is already configured.

Install From Releases

Download a binary from the GitHub releases, make it executable, and move it somewhere on your PATH.

chmod +x gtl-darwin-arm64
mv gtl-darwin-arm64 /usr/local/bin/gtl

Verify

gtl --version
gtl --help

Requirements

• Go 1.25+ when building from source
• Git 2+
• GitHub CLI (gh) for GitHub account inspection and per-repo auth helpers such as gtl env and gtl whoami
• GitLab CLI (glab) for GitLab account inspection with gtl env connect glab and gtl env check
• GITHUB_TOKEN for GitHub API-backed commands
• GITLAB_TOKEN for GitLab API-backed commands

First Commands

gtl status
gtl branch
gtl commit "describe the change"
gtl pr --help
gtl worktree list

Use the command reference when you need exact flags, aliases, examples, or subcommands.