gastown

What problem does it solve?

Gas Town coordinates multiple Claude Code agents to automate cross-rig project work. It provides a unified orchestration layer that makes dispatching, monitoring, and merging tasks seamless across rigs, reducing context switching and errors.

Core Features & Use Cases

• Cross-rig orchestration: Dispatch work to witnesses, refineries, polecats, or crew to automate end-to-end pipelines.
• Beads-based memory and messaging: Persist work state and enable async handoffs via mail and hooks.
• Merge pipeline control: Manage the complete flow from sling to merge to main with visibility and recovery options.
• Troubleshooting and diagnostics: Built-in doctor checks and recovery procedures to keep the engine running.
• Real-world use: Hook a GitHub project, track issues as beads, sling to workers, and observe per-rig workflows at scale.

Quick Start

Follow these steps to get Gas Town running and hook up your first project:

• Install the Gas Town CLI (gt) and Beads (bd), verify versions.
• Initialize a workspace at ~/gt with gt install ~/gt.
• Add a rig with gt rig add myproject https://github.com/owner/repo.git.
• Sling a bead to a polecat and observe with gt polecat list and gt status.
• Start the refinery with gt refinery start and monitor with gt refinery status.
• If issues arise, run gt doctor and bd doctor for health checks.