Gas Town
Gas Town is a multi-agent orchestration system for Claude Code and Codex with persistent work tracking. It provides a workspace manager for coordinating multiple agents, while storing work state in git-backed hooks so agent restarts do not lose context.
Why Gas Town
Gas Town is designed to make multi-agent collaboration reliable and scalable.
| Challenge | Gas Town Solution |
|---|---|
| Agents lose context on restart | Work persists in git-backed hooks |
| Manual agent coordination | Built-in mailboxes, identities, and handoffs |
| 4–10 agents become chaotic | Scale comfortably to 20–30 agents |
| Work state lost in memory | Work state stored in Beads ledger |
Core building blocks
- Mayor — the primary AI coordinator that knows the workspace and orchestrates agents.
- Town — the workspace directory (for example,
~/gt/). - Rigs — project containers that wrap a git repository and manage its agents.
- Crew members — your hands-on workspace inside a rig.
- Polecats — ephemeral worker agents.
- Hooks — git worktree-based storage that persists agent state.
- Convoys — work tracking units that bundle multiple beads.
Ready to get going? Start with the installation and quick start guides.