gastownhall/gascity

What it solves

Gas City provides a composable orchestration infrastructure for multi-agent coding workflows. It solves the problem of managing the complex underlying infrastructure—such as runtime providers, work routing, and state reconciliation—required to run multiple AI agents in a coordinated fashion.

How it works

Gas City acts as an orchestration-builder SDK that uses a declarative configuration file (city.toml) to define the system's state. It employs a controller/supervisor loop that continuously reconciles the desired state defined in the configuration to the actual running state. The system supports multiple runtime providers (including tmux, subprocess, Kubernetes, and herdr) to execute agents and uses a "beads" system for tracking work, mail, and convoys.

Who it’s for

It is designed for developers building multi-agent systems, specifically those creating complex coding workflows where agents need to be orchestrated across different environments and project setups.

Highlights

• Declarative Configuration: Uses city.toml for easy system setup and management.
• Flexible Runtimes: Supports a wide array of execution backends including tmux, Kubernetes, and subprocesses.
• State Reconciliation: Features a supervisor loop that ensures the running state matches the desired configuration.
• Work Tracking: Implements a beads-backed system for managing work, formulas, and communication between agents.