Summary

Gas City is an orchestration-builder SDK for multi-agent coding workflows, extracting reusable infrastructure from the Gas Town project into a configurable toolkit. It offers a primitive-first model, targeting experienced Gas Town users and developers building complex multi-agent systems by providing flexible runtime management and work routing.

How It Works

The system employs a primitive-first model with a controller/supervisor loop that reconciles desired state to running state. It supports multiple runtime providers including tmux, subprocess, exec, ACP, and Kubernetes. Work tracking, formulas, and inter-agent communication are managed via a "Beads" system, which can be file-based or use providers like dolt and bd. The SDK facilitates multi-project setups through packs, overrides, and rig-scoped orchestration.

Quick Start & Requirements

Installation is available via Homebrew (brew install gastownhall/gascity/gascity). Building from source requires make and Go 1.25+. Core system prerequisites include tmux, git, jq, pgrep, and lsof. The default "bd" Beads provider requires dolt, bd, and flock. Specific AI model providers (Claude, Codex, Gemini) have their own setup documentation. Official documentation is available at docs/ with specific guides for Installation, Quickstart, and Tutorials.

Highlighted Details

• Supports diverse runtime environments: tmux, subprocess, exec, ACP, and Kubernetes.
• Features a Beads-backed system for work tracking, formulas, and inter-agent messaging.
• Includes a controller/supervisor loop for declarative state reconciliation.
• Offers rig-scoped orchestration for managing multi-project configurations.

Maintenance & Community

Contribution guidelines are detailed in CONTRIBUTING.md and engdocs/contributors/index.md. The project provides commands for setup, checking, documentation checks, and integration tests (make setup, make check, etc.). Specific community channels (e.g., Discord, Slack) or roadmap links are not detailed in the provided README.

Licensing & Compatibility

The project is licensed under the MIT license. This license is permissive and generally compatible with commercial use and linking within closed-source projects.

Limitations & Caveats

Building from source necessitates Go 1.25+. The default "bd" Beads provider introduces dependencies on dolt, bd, and flock. Integration with AI model providers like Claude, Codex, or Gemini requires separate setup as per their respective documentation.