5e9b204d2b
- Remove "IDE of 2026" and "Integrated Delegation Engine" claims - Rename "Core Innovations" to "Ideas We're Exploring" - Remove "Universal" from data plane and propulsion docs - Add experimental status badges - Frame concepts as discovery, invite others to explore Closes gt-qvn7.5.2 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.5 KiB
2.5 KiB
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