gastownhall/gastown

What is it?

Key features

• 01Coordinates multiple AI coding agents through a Mayor coordinator and worker agents.
• 02Persists agent work state in git worktree-based hooks so it survives restarts.
• 03Bundles issues into convoys and tracks their progress.
• 04Runs a Bors-style merge queue that keeps agents from pushing directly to main.
• 05Monitors stuck or dead agents with a feed TUI and a web dashboard.
• 06Supports Claude Code, Codex, Gemini, Cursor, Copilot and other runtimes.

Use cases

• Running 10 to 30 AI coding agents in parallel across several repositories.
• Coordinating long multi-issue feature work that must survive agent restarts.
• Gating AI-generated changes through a verified merge queue before they reach main.

Quick start

1. 1

   Set git identity

   git config --global user.name "Your Name" && git config --global user.email "you@example.com"
2. 2

   Create workspace and start services

   gt install ~/gt --shell --git && cd ~/gt && gt up
3. 3

   Verify the install

   gt doctor --fix
4. 4

   Start the Mayor and tell it what to build

   gt mayor attach

Things to know

• !Native installs need several extra tools: Go 1.26.2+, Dolt, Beads (bd), tmux 3.0+ and ICU4C headers.
• !Native Windows is best treated as a CLI-only environment; full tmux workflows need WSL or Linux.
• !Avoid go install on macOS because the unsigned binary is killed by Gatekeeper; use Homebrew or build from source.

Topics

FAQ

What is gastown?

Go-based workspace manager that coordinates multiple AI coding agents such as Claude Code, Copilot and Codex, persisting their work state in git-backed hooks. Gas Town is a workspace manager for running several AI coding agents at once on different tasks. Agents often lose context when they restart; Gas Town stores work state in git-backed hooks (git worktrees) and in a Beads ledger so that work survives crashes and restarts.

Is gastown free to use? What license does it have?

gastown is open source under the MIT license. Check the license terms before using it in commercial products.

Is gastown still maintained?

Actively maintained. The last commit to gastown was on Oct 18, 2026.

What can I use gastown for?

Running 10 to 30 AI coding agents in parallel across several repositories. Coordinating long multi-issue feature work that must survive agent restarts. Gating AI-generated changes through a verified merge queue before they reach main.

How do I install gastown?

Set git identity: git config --global user.name "Your Name" && git config --global user.email "you@example.com" Create workspace and start services: gt install ~/gt --shell --git && cd ~/gt && gt up Verify the install: gt doctor --fix Start the Mayor and tell it what to build: gt mayor attach

Where can I get gastown?

The source code and installation instructions are on GitHub: https://github.com/gastownhall/gastown