gastownhall/gastown

Gas Town is a workspace manager for running and coordinating many AI coding agents at once. The README pitches it as a way to run Claude Code, GitHub Copilot, Codex, Gemini, and similar tools side by side on different tasks, with the work they do persisted to disk so that nothing is lost when an agent restarts or its session ends. The stated goal is to scale comfortably from a handful of agents up to twenty or thirty without the setup collapsing into chaos. The project leans hard into a small-town metaphor for its concepts. Your workspace directory, usually at ~/gt/, is called a Town. Each project inside the Town is a Rig, which wraps a single git repository and the agents attached to it. A Crew Member is your own workspace inside a rig, while Polecats are worker agents spawned to do tasks. Sitting above all of this is The Mayor, a Claude Code instance described as the primary coordinator that knows the full context of your workspace and that you talk to first. Work history and state are stored in Hooks, which are git worktrees used as persistent storage that survives crashes and restarts. Work itself is tracked with two further concepts. Beads are individual work items, with IDs like gt-abc12, stored by a separate tool called beads (bd) as the git-backed ledger. Convoys bundle beads assigned to agents, with a mountain label that turns on stall detection for long-running epics. Workflow templates called Molecules define multi-step pipelines in TOML. Gas Town has a three-tier watchdog setup. A Witness monitors the polecats inside one rig, the Deacon runs continuous background patrols across all rigs, and Dogs are workers the Deacon dispatches for maintenance. A per-rig Refinery acts as a merge queue, batching merge requests, running verification gates, and merging to main using a Bors-style bisecting queue. Agents that hit blockers can escalate at three severity levels. A Scheduler caps concurrent dispatch to avoid API rate limits. Installation needs Go 1.25 or later, Git 2.25 or later, the Dolt database, the beads tool, sqlite3, tmux, and the Claude Code CLI by default. Installation is offered through Homebrew, npm, building from source, or Docker Compose. A Wasteland feature links separate Gas Towns through DoltHub so they can post and claim work between each other.