Gas Town is an open-source multi-agent harness and orchestration runtime designed to supervise, manage, and coordinate autonomous coding agents across complex software projects. Created by Steve Yegge and the gastownhall organization, it operates as a supervisory layer over terminal-based developer agents. Gas Town coordinates underlying agent runtimes—including Claude Code, OpenAI Codex, Cursor Agent (`cursor-agent`), and GitHub Copilot CLI—inside structured tmux sessions and background processes. It monitors agent process lifecycles via the `gt` CLI, handling orphan process detection, readiness polling, turn boundary drains, and dashboard state tracking. The system integrates closely with `beads` issue tracking and task graph structures to hand off units of work (molecules and tasks) to individual worker agents. Unlike standalone CLI coding agents, Gas Town is a full supervisor harness built to govern agent swarms. It includes built-in subsystem roles such as automated PR sheriffs, background reapers for alert thresholds, and dynamic runtime doctor checks that verify permission flags, zombie processes, and environment hygiene across agent sessions. Gas Town is free and open-source software distributed on GitHub under an open-source license. It is built primarily in Go and shell scripts to interface directly with operating system process trees and terminal multiplexers.
Multi-Agent Runtime Orchestration — Manages and isolates multiple CLI agent instances, including Claude, Cursor Agent, Copilot CLI, and Codex, within managed tmux environments. - Process & Orphan Management — Detects zombie sessions, runaway TTY instances, and orphaned agent processes across town root workspaces using built-in doctor commands. - Beads Task Integration — Coordinates task decomposition and handoffs using structured bead files, molecule graphs, and automated issue tracking. - PR Sheriff & Review Automation — Enforces automated pull request validation, code checking, and merge paths before code integration. - Readiness Polling & Turn Boundary Control — Manages agent readiness delays, prompt prefixes, and turn drain cycles to ensure reliable multi-agent execution. - Interactive Crew Dashboard — Provides status visibility into active agent panes, commands, and runtime health across complex workflows.
Use cases
Use Case: Autonomous Multi-Agent Task Orchestration A development team uses Gas Town to break down large engineering initiatives into molecule beads and delegate implementation subtasks concurrently across Claude, Cursor, and Copilot instances running in supervised tmux panes.
Use Case: Automated PR Verification & Quality Gating Teams configure Gas Town's PR sheriff subsystems to evaluate inbound pull requests, execute automated verification checks, inspect evidence, and auto-merge safe patches without manual engineering overhead.
Use Case: Agent Health Monitoring & Process Hygiene Engineers running continuous autonomous coding loops use the gt CLI doctor and reaper tooling to prune zombie agent processes, enforce permission flags, and track session lifecycles across local development machines.
Who it is for
Gas Town is designed for senior engineers, infrastructure developers, and teams building or running multi-agent autonomous coding swarms in terminal environments. It is not intended for casual users seeking a simple single-turn chat interface or beginner IDE plugin.
Install guide
Installation Gas Town is maintained as a Go-based orchestration CLI (gt). Clone the repository and install the binary locally: bash git clone https://github.com/gastownhall/gastown.git cd gastown go install ./... Ensure tmux and your preferred coding agent binaries (such as claude, cursor-agent, or copilot) are installed on your PATH.
First Run Verify that the Gas Town runtime environment and process doctor checks pass: bash # Run the environment doctor to check for required tools and agent presets gt doctor # Initialize the Gas Town workspace in your project repository gt init
Example Session Launch Gas Town to manage worker agent sessions and monitor crew activity: bash # Start Gas Town runtime with your configured agent preset gt up --agent cursor # Inspect active crew panes and running task beads gt status # Safely stop running worker sessions and sweep orphaned processes gt down
SWE-agent — SWE-agent is an open-source autonomous software engineering agent harness built and maintained by researchers from Princeton University and Stanford University.…
Agent Runbook — Agent Runbook is an open-source contract-based multi-agent skill framework developed by KnoxOps. It acts as an orchestrator and compiler that…
Weaver — Weaver is an open-source agent harness and orchestration framework maintained by sean35mm on GitHub. Built on top of the Bun…
Context Bridge — Context Bridge is an open-source CLI agent harness and context orchestration utility developed by serdardb. It is built to facilitate…
Hivelore — Hivelore is an open-source agent harness and contextual memory orchestrator created by Doucs91. It provides persistent project memory, decision tracking,…
Agentic Engineering Framework — Agentic Engineering Framework is an open-source orchestration harness and governance layer developed by Dimitri Geelen. It is designed to constrain,…