Gas Town

Gas Town keeps a town workspace (default ~/gt) that contains rigs, one per git repository. Agents run as tmux sessions of ordinary coding-agent CLIs; Gas Town launches them, sends input with tmux and environment variables, and does not link against agent code. Roles are the Mayor (global coordinator), Deacon (background supervisor), per-rig Witness (lifecycle manager) and Refinery (merge queue), and workers: polecats (Witness-managed) and crew (user-managed clones).

Work is tracked as beads in the Beads git-backed issue store on Dolt, grouped in convoys and dispatched with gt sling. Polecat state is stored in git worktree-based hooks so a crashed or restarted session can resume; the Mayor and agents exchange mail and nudges. When a polecat finishes with gt done, the Refinery verifies and merges to main.

A minimal mode skips tmux: convoys and slings track state while the user runs claude or codex by hand. The Docker Compose setup runs the whole town in a container.

The human is the Overseer at the top of the escalation chain: agents that cannot resolve a blocker escalate to the Deacon, then the Mayor, then the Overseer, with CRITICAL and HIGH items also routed by email or SMS. Convoys can name subscribers with --notify, including --human, who are told when the convoy lands (all tracked issues closed). The user can attach to the Mayor session at any time and monitors work with gt convoy list, gt agents and gt feed. There is no documented per-action approval gate; the Refinery merges after its verification gates.

brew install gastown

brew install gastown                       # installs gt, bd and dolt (macOS)
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

gt install ~/gt --shell --git             # create the town (HQ)
cd ~/gt
gt up                                      # start Dolt, daemon, Deacon, Mayor, Witnesses, Refineries
gt doctor --fix

gt rig add myproject https://github.com/you/repo.git
gt mayor attach                            # tell the Mayor what to build

gt convoy create "Feature X" gt-abc12 --notify --human   # inside the Mayor session
gt sling gt-abc12 myproject                # assign a bead to a worker
gt convoy list
gt agents

• Native installs need Git 2.20+, Go 1.26.2+ (Linux, Windows, source builds), Beads (bd) 0.57.0+, sqlite3, tmux 3.0+ and a coding-agent CLI (Claude Code is the default runtime).
• On macOS use brew install gastown; the README says go install produces a binary that Gatekeeper kills.
• Windows: full tmux-backed workflows need WSL; native shells are minimal CLI-only, and source builds need an MSYS2 toolchain with ICU.
• Rig names allow letters, digits and underscores only (my_project, not my-project).
• For Codex, set project_doc_fallback_filenames = ["CLAUDE.md"] in ~/.codex/config.toml; runtimes without hooks get a startup fallback.
• The GitHub Copilot preset uses --yolo and needs a Copilot seat.
• With Docker Compose, do not point FOLDER at a workspace a native install is using, and treat the dashboard port as a trusted local-network surface.

Not according to the README or docs I read, so the record marks it unknown. It coordinates agents through tmux, mail and its own CLI.

Claude Code is the default runtime. Built-in presets include Codex, OpenCode, Gemini, Cursor, Copilot, Amp and others, and any CLI that runs in a terminal works at the basic integration tier. OpenClaw and Hermes are not listed.

Yes. It is MIT licensed and no paid product is documented. Your coding agents' own usage costs are separate, and the scheduler can cap concurrent workers.

Polecat work state lives in git worktree-based hooks, and crew members have their own clones. The docs describe worktrees for state, not a sandbox for execution.

The tmux-backed roles (Mayor, Witnesses, Refineries, polecats) need tmux 3.0+. A minimal mode without tmux only tracks state while you run the agent CLIs yourself.