Frequently Asked Questions

Gas Town is an orchestration layer for AI coding agents. It helps you manage multiple Claude Code instances simultaneously, tracking accountability, measuring quality, and scaling your AI-assisted engineering workflows.

As AI agents become central to engineering workflows, teams face challenges around accountability (who did what?), quality (which agents are reliable?), efficiency (how to route work?), and scale (how to coordinate agents across repos?). Gas Town treats AI agent work as structured data where every action is attributed and every agent has a track record.

Polecats are ephemeral worker agents that produce Merge Requests. They are spawned for specific tasks, complete their work in isolated git worktrees to avoid conflicts, and are then cleaned up. Polecats are managed by the Witness agent.

A Convoy is how you track batched work in Gas Town. When you kick off work—even a single issue—you create a convoy to track it. Convoys provide a single view of what is in flight, cross-rig tracking, auto-notification when work lands, and historical records of completed work.

Crew members are long-lived, persistent agents for ongoing collaboration—you control their lifecycle. Polecats are ephemeral workers managed by the Witness that are spawned for specific tasks and automatically cleaned up. Use Crew for exploratory work and long-running projects; use Polecats for discrete, well-defined, parallelizable tasks.

GUPP stands for Gas Town Universal Propulsion Principle: "If there is work on your Hook, YOU MUST RUN IT." This ensures agents autonomously proceed with available work without waiting for external input. It is the heartbeat of Gas Town's autonomous operation.

MEOW stands for Molecular Expression of Work. It is the principle of breaking large goals into detailed instructions for agents, supported by Beads, Epics, Formulas, and Molecules. MEOW ensures work is decomposed into trackable, atomic units that agents can execute autonomously.

A Bead is a git-backed atomic work unit stored in JSONL format. Beads are the fundamental unit of work tracking in Gas Town. They can represent issues, tasks, epics, or any trackable work item.

The Mayor is the chief-of-staff agent responsible for initiating Convoys and coordinating work distribution. The Deacon is a daemon that runs continuous Patrol cycles to ensure worker activity and system health. The Witness is a per-rig patrol agent that oversees Polecats and the Refinery.

No. Gas Town lets you run unlimited AI agents using your existing Max/Pro subscriptions. There are no per-token API costs or usage caps—you leverage the subscriptions you already pay for.