Generated by Code IQ · v1.0

gastown
Knowledge Tutorial

Gas Town is a multi-agent orchestration system designed to manage AI coding workflows with persistent state. It organizes work into self-contained Rigs, employs ephemeral Polecat agents to execute tasks, and utilizes a git-backed ledger called Beads (powered by Dolt) to ensure no context is lost between restarts. The system automates the full development lifecycle, from assigning batched work via Convoys to merging code through an autonomous Refinery.

7
Chapters
-
Subsystems
Rabbit Holes
▶ Start Reading ⎇ View on GitHub
System Architecture

How the pieces fit

gastown is organized as connected concepts and components. Start broad, then drill down chapter by chapter.

⚙️
Rigs (Project Containers)
Rigs (Project Containers)
⚙️
Polecats (Ephemeral Workers)
Polecats (Ephemeral Workers)
⚙️
Molecules (Workflow Engines)
Molecules (Workflow Engines)
⚙️
Beads & Dolt (The Ledger)
Beads & Dolt (The Ledger)
⚙️
Convoys (Work Logistics)
Convoys (Work Logistics)
⚙️
Refinery (The Merge Engineer)
Refinery (The Merge Engineer)
⚙️
Mail Router (Communication Bus)
Mail Router (Communication Bus)
gastown — bash
open tutorial
◆ Scanning numbered chapters
◆ Building navigation and Mermaid diagrams
◆ Generating chapter and subsystem pages
✓ 7 chapter pages built
✓ Theme toggle enabled
Repository Overview

Intro and Architecture Diagram

Gas Town is a multi-agent orchestration system designed to manage AI coding workflows with persistent state. It organizes work into self-contained Rigs, employs ephemeral Polecat agents to execute tasks, and utilizes a git-backed ledger called Beads (powered by Dolt) to ensure no context is lost between restarts. The system automates the full development lifecycle, from assigning batched work via Convoys to merging code through an autonomous Refinery.

Source Repository: https://github.com/steveyegge/gastown

flowchart TD A0["Rigs (Project Containers)"] A1["Polecats (Ephemeral Workers)"] A2["Molecules (Workflow Engines)"] A3["Beads & Dolt (The Ledger)"] A4["Mail Router (Communication Bus)"] A5["Refinery (The Merge Engineer)"] A6["Convoys (Work Logistics)"] A0 -->|"Hosts and manages"| A1 A0 -->|"Contains"| A5 A2 -->|"Guides execution steps"| A1 A6 -->|"Tracks batch progress"| A3 A1 -->|"Persists work state"| A3 A4 -->|"Delivers and stores messages"| A3 A5 -->|"Notifies of merge failures"| A4 A5 -->|"Triggers progress checks"| A6
Tutorial Chapters

All 7 chapters

Follow sequentially or jump to any topic. Start with Rigs (Project Containers).

About This Project

Generated by Code IQ

This tutorial was automatically generated by Code IQ and rendered with the shared tutorial site builder. It can be produced for any repository tutorial folder that follows the numbered markdown chapter layout.

View Code IQ ↗
python build_site.py '/home/runner/work/Code-IQ/Code-IQ/output/gastown'

// → 7 chapters
// → source: steveyegge/gastown