de04f4177c
Gas Town is a stream engine, not a swarm engine. Polecats can start and land independently at any time. "Swarm" is used lightly for batch coordination, but there are no swarm IDs or batch boundaries. Changes: - architecture.md: Add stream engine intro paragraph, update references from "swarming" to "parallel polecats" or "batch" - prompts.md: Rename SWARM_* messages to BATCH_*, update terminology - crew.md.tmpl: Replace "swarm" references with "transient worker pool" and "batch work" The gt swarm command and internal/swarm/ package remain as-is since they provide the tooling for batch operations. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Gas Town
Status: Experimental (v0.1) - We're exploring these ideas and invite you to explore with us.
Gas Town is an experiment in multi-agent coordination for Claude Code. It provides infrastructure for spawning workers, tracking work via molecules, and coordinating merges.
We think of it using steam-age metaphors:
Claude = Fire (the energy source)
Claude Code = Steam Engine (harnesses the fire)
Gas Town = Steam Train (coordinates engines on tracks)
Beads = Railroad Tracks (the persistent ledger)
The goal is a "village" architecture - not rigid hierarchy, but distributed awareness where agents can help neighbors when something is stuck. Whether this actually works at scale is something we're still discovering.
Install
go install github.com/steveyegge/gastown/cmd/gt@latest
Quick Start
# Create a town (workspace)
gt install ~/gt
# Add a project rig
gt rig add myproject --remote=https://github.com/you/myproject.git
# Spawn a worker on an issue
gt spawn --issue myproject-123
Architecture
Town (~/gt/)
├── Mayor (global coordinator)
└── Rig: myproject
├── Witness (lifecycle manager)
├── Refinery (merge queue)
└── Polecats (workers)
Key Concepts
Ideas we're exploring:
- Molecular Chemistry of Work: Protos (templates) → Mols (flowing work) → Wisps (ephemeral) → Digests (outcomes)
- Beads: Git-backed, human-readable ledger for tracking work (github.com/steveyegge/beads)
- Village Model: Distributed awareness instead of centralized monitoring
- Propulsion Principle: Agents pull work from molecules rather than waiting for commands
- Nondeterministic Idempotence: The idea that any worker can continue any molecule after crashes
Some of these are implemented; others are still aspirational. See docs for current status.
Commands
gt status # Town status
gt rig list # List rigs
gt spawn --issue <id> # Start worker
gt mail inbox # Check messages
gt peek <worker> # Check worker health
gt nudge <worker> # Wake stuck worker
Documentation
- Vision - Core innovations and philosophy
- Architecture - System design
- Molecular Chemistry - Work composition
- Molecules - Workflow templates
Development
go build -o gt ./cmd/gt
go test ./...
License
MIT