Skip to main content

Installation

Prerequisites​

  • Go 1.23+ — https://go.dev/dl
  • Git 2.25+ — required for worktree support
  • beads (bd) 0.44.0+ — https://github.com/steveyegge/beads
  • sqlite3 — used for convoy database queries
  • tmux 3.0+ — recommended for the full experience
  • Claude Code CLI or Codex CLI — supported runtimes

Install Gas Town​

# Install the CLI
go install github.com/steveyegge/gastown/cmd/gt@latest

# Add Go binaries to PATH (update ~/.zshrc or ~/.bashrc)
export PATH="$PATH:$HOME/go/bin"

Initialize a workspace​

# Create workspace with git initialization
gt install ~/gt --git
cd ~/gt

Add a project rig and crew​

# Add your first project rig
gt rig add myproject https://github.com/you/repo.git

# Create your crew workspace
gt crew add yourname --rig myproject
cd myproject/crew/yourname

Start the Mayor​

gt mayor attach

The Mayor is the primary interface for orchestrating agents and convoys.