Installation
Install Gas Town
- Homebrew (Recommended)
- npm
- Build from Source
brew install gastown
npm install -g @gastown/gt
git clone https://github.com/steveyegge/gastown.git
cd gastown
go build -o gt ./cmd/gt/
sudo mv gt /usr/local/bin/
Install Dependencies
Git (Required)
Gas Town relies on git worktrees for file-level isolation between agents. Git 2.25+ is required.
git --version
# Should show 2.25.0 or higher
If your version is older, update via your package manager (brew upgrade git, sudo apt install git, etc.).
Beads (Issue Tracking)
Beads is the git-backed issue tracking system that Gas Town uses for work management.
# Install beads
brew install beads
# Or: npm install -g @beads/bd
Verify installation:
bd --version
# Should show 0.44.0 or higher
Tmux (Recommended)
Tmux enables Gas Town to manage multiple agent sessions in split panes.
# macOS
brew install tmux
# Ubuntu/Debian
sudo apt install tmux
# Amazon Linux
sudo yum install tmux
Claude Code CLI
Gas Town builds on Claude Code as its primary runtime. Install it following the official instructions.
# Verify Claude Code is available
claude --version
Shell Completions
Install tab completions for better CLI experience:
# Bash
gt completion bash > /etc/bash_completion.d/gt
# Zsh
gt completion zsh > "${fpath[1]}/_gt"
# Fish
gt completion fish > ~/.config/fish/completions/gt.fish
Verify Installation
gt --version
gt help
You should see the Gas Town help output listing all available commands.
Supported Runtimes
Gas Town supports multiple AI coding agent runtimes:
| Runtime | Command | Notes |
|---|---|---|
| Claude Code | claude | Default, recommended |
| Gemini CLI | gemini | Google's coding agent |
| Codex | codex | OpenAI's coding agent |
| Cursor | cursor | Cursor IDE agent |
| Auggie | auggie | Augment agent |
| Amp | amp | Sourcegraph agent |
Configure the default runtime:
gt config default-agent claude
gt config agent set gemini "gemini"