What is Gas Town?
Gas Town is an open-source workspace manager for coordinating multiple AI coding agents across projects. Gas Town supports Claude Code, GitHub Copilot, Codex, Gemini, and other agents. Developers use Gas Town to assign separate tasks while retaining work state outside individual agent sessions, addressing the loss of context that can occur when agents restart.
Gas Town organizes a workspace into project containers called rigs, each wrapping a Git repository. Personal workspaces are called crew members, while worker agents are called polecats. The Mayor, a Claude Code instance with workspace context, acts as the primary coordinator across projects and agents.
What Gas Town can do
Gas Town combines task coordination, persistent storage, and operational supervision for agent-driven development. Gas Town stores work in Git worktree-based hooks and uses Beads for structured issue tracking. Convoys group work items for assignment, while workflow templates track multi-step work and can provide checkpoint recovery.
- Gas Town preserves agent work through crashes and restarts.
- Gas Town provides mailboxes, identities, and handoffs for agent coordination.
- Gas Town groups Beads issues into assignable convoys.
- Gas Town runs workflow templates with tracked steps.
- Gas Town monitors stuck agents and triggers recovery.
- Gas Town verifies and merges completed work through a merge queue.
- Gas Town batches agent dispatch under configurable concurrency limits.
How Gas Town works
Gas Town can run directly on a host or inside a Docker Compose container. Native setup involves installing the required tools, creating a headquarters workspace with gt install, and starting services with gt up. Developers can then check the installation with gt doctor --fix and add a repository with gt rig add.
Gas Town separates hands-on development from delegated agent work. Developers create a personal crew workspace and attach to the Mayor to coordinate tasks. Worker sessions end when tasks finish, but worker identities and work histories persist. The Refinery processes completed merge requests, runs verification gates, and isolates failed requests for correction or reassignment.
Who Gas Town is for
Gas Town is for developers managing multiple AI coding agents rather than relying on a single agent session. Gas Town supports work across separate repositories and provides explicit mechanisms for task assignment, progress tracking, recovery, and merging. Developers can also use the Mayor to coordinate goals across the workspace.
- Gas Town coordinates separate coding tasks across project repositories.
- Gas Town preserves work state when agent sessions restart.
- Gas Town tracks multi-step development work through workflow templates.
- Gas Town manages verification and merging after worker tasks finish.
Gas Town pricing and access
Gas Town is available as an open-source GitHub project under the MIT license. Gas Town provides native installation instructions for macOS, Linux, and Windows, alongside a Docker Compose setup path. Homebrew installs Gas Town with Beads and Dolt on macOS; other native paths require separate supporting-tool installation.
Gas Town strengths and limitations
Gas Town combines persistent work tracking with agent coordination, monitoring, and merge processing. Gas Town offers both host and container deployment paths and supports several coding runtimes. Setup still involves development tooling and environment configuration, and the documented Windows and macOS paths include restrictions that affect how developers install and run the system.
- Gas Town requires supporting tools for native installation.
- Gas Town requires tmux for its full managed-role workflows.
- Gas Town needs WSL or another Linux environment for full tmux-backed Windows workflows.
- Gas Town warns against macOS go install because Gatekeeper kills the resulting unsigned binary.
Gas Town FAQ
What is Gas Town?
Gas Town is an open-source workspace manager for coordinating multiple AI coding agents across Git repositories. Gas Town combines persistent Git-backed work storage, Beads issue tracking, agent coordination, monitoring, and merge processing.
Is Gas Town open source?
Gas Town is an open-source project available on GitHub under the MIT license. Gas Town provides installation paths for running directly on a host or inside a Docker Compose container.
Which AI coding agents does Gas Town support?
Gas Town supports Claude Code, GitHub Copilot, Codex, Gemini, and other AI coding agents. Gas Town uses Claude Code as the default runtime, and the documentation also lists Cursor among alternative runtime configurations.
How does Gas Town preserve work between agent sessions?
Gas Town preserves agent work in Git worktree-based hooks that survive crashes and restarts. Gas Town also stores structured work state in Beads, while worker agents retain persistent identities and work histories despite having temporary sessions.
Can Gas Town run on Windows?
Gas Town provides a native Windows installation path, but full tmux-backed workflows require WSL or another Linux environment. Gas Town describes native Windows shells as minimal CLI-only environments and documents additional requirements for source builds using the ICU-backed query layer.
From the community
No reviews yet
Be the first to review this tool. What you write helps the next person choose.




