Home
Composable orchestration infrastructure for multi-agent coding workflows.
Gas City is an orchestration-builder SDK for multi-agent systems. It extracts the reusable infrastructure from Gas Town into a configurable toolkit — with runtime providers, work routing, formulas, orders, health patrol, and a declarative city configuration — so you can scale your coding agents as far as your machine will take you.
| Feature | Description |
|---|---|
| Declarative config | Define your city in city.toml — agents, packs, rigs, and runtime providers all in one place |
| Multiple runtimes | tmux, subprocess, exec, ACP, and Kubernetes — run your agents wherever you want |
| Beads work tracking | Reliable, durable work queues backed by Dolt or a file store |
| Formulas & orders | Compose reusable workflows and schedule periodic or triggered tasks |
| Controller loop | A supervisor reconciles desired state to running state automatically |
| Packs ecosystem | 21 example packs available; share, reuse, and compose building blocks for your city |
brew install gastownhall/gascity/gascity
gc init ~/my-city
cd ~/my-city
gc startOr build from source (requires make and Go 1.25+):
make installSee the full Installation Guide and Quickstart for details.
As of the latest Dashboard snapshot (v1.1.0):
| Signal | Value |
|---|---|
| ⭐ Stars | 828 |
| 🍴 Forks | 264 |
| 📥 Release downloads | 3,776 total |
| ✅ CI success rate (7d) | 80.5% |
| 👥 Unique visitors (14d) | 2,711 |
| 🌱 Community profile score | 87% |
A live project health dashboard that tracks executive signals, reach & adoption, CI metrics, community activity, and security alerts — all automatically updated on a weekly cadence. Use it to get a quick read on how the project is doing across every dimension: traffic, CI health, PR throughput, and more.
🗺️ Roadmap
The forward-looking plan for Gas City's evolution. Current focus areas include reliability and efficiency improvements (CPU/RAM, data integrity, agent efficiency), a v3 orchestration layer upgrade with parallel convoy review, a new recommended Gas City starter pack (Plan, Design, Implement, Bug Fix, PR Review), factory-floor visualization tooling, a pack registry for discovery and sharing, and longer-term team-based usage patterns. All aspirational — community input welcomed!
We'd love your help! Read CONTRIBUTING.md and the contributor guide before opening a PR.
make setup
make check
make test-integrationIssues, feature requests, and discussion all welcome — 275 open issues and counting. Check out Discussions to connect with the community.
Gas City is MIT licensed. Built with ☕ by gastownhall and contributors.