Home
features, schedule, quality: pick 3
Gas City is platform for building software factories.
| 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 startSee 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 Discord to connect with the community.
Gas City is MIT licensed. Built with ☕ by gastownhall and contributors.