Gas Town is a multi-agent workspace manager designed to orchestrate multiple Claude Code agents, addressing the challenge of lost context during agent restarts. It provides persistent work tracking via git-backed hooks, enabling reliable and scalable multi-agent workflows for users coordinating complex AI tasks.

How It Works

Gas Town employs a hierarchical architecture centered around a "Mayor" AI coordinator. The "Town" is the workspace directory, containing "Rigs" which are project containers wrapping git repositories. Each Rig manages "Polecats" (ephemeral worker agents) and "Hooks" (git worktrees) for persistent storage. Agent work state is stored in these git worktrees, ensuring persistence across restarts and providing version control. "Convoys" bundle tasks, and "Beads" integration offers git-backed issue tracking for structured work state management. This approach leverages git's robustness for state management, enabling coordination and handoffs between agents.

Quick Start & Requirements

• Prerequisites: Go 1.23+, Git 2.25+, beads (bd) 0.44.0+, Claude Code CLI, tmux 3.0+.
• Installation: Install the gt CLI via go install github.com/steveyegge/gastown/cmd/gt@latest. Ensure Go binaries are in your PATH.
• Setup: Initialize workspace with gt install ~/gt --git, add a project rig with gt rig add <name> <repo>, create a crew workspace with gt crew add <name> --rig <rig>, then attach to the Mayor with gt mayor attach.
• Docs: Official quick-start guide integrated into the README.

Highlighted Details

• MEOW (Mayor-Enhanced Orchestration Workflow): A recommended pattern where users instruct the Mayor, which then breaks down tasks, creates convoys, spawns agents, assigns work (slings issues), and monitors progress.
• Beads Integration: Enables defining and executing repeatable workflows (formulas) using TOML, with robust issue tracking and state management.
• Git Hooks as Propulsion: Utilizes git worktrees for persistent, version-controlled, and rollback-capable storage of agent work state, surviving crashes.
• Web Dashboard: A built-in dashboard (gt dashboard) provides real-time monitoring of agent status, convoy progress, and hook state visualization.
• Shell Completions: Available for Bash, Zsh, and Fish shells for enhanced command-line usability.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or project roadmap were present in the provided README content.

Licensing & Compatibility

• License: MIT License.
• Compatibility: The MIT license is permissive, generally allowing for commercial use and integration within closed-source projects.

Limitations & Caveats

The system relies on specific versions of Go, Git, and the Claude Code CLI, which may present setup hurdles. While designed for persistence, agent state management is tied to git worktree integrity. The complexity of coordinating multiple agents and components (Mayor, Rigs, Hooks, Convoys, Beads) requires a learning investment.