back to home

gastownhall / gascity

Orchestration-builder SDK for multi-agent coding workflows

View on GitHub
51 stars
22 forks
51 issues

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing gastownhall/gascity in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/gastownhall/gascity)
Preview:Analyzed by RepoMind

Repository Overview (README excerpt)

Crawler view

Gas City 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. Coming from Gas Town? Start with Coming from Gas Town?. It maps Town roles, commands, plugins, convoys, and directory habits onto Gas City's primitive-first model so experienced Gas Town users can ramp without trying to port the entire Town architecture literally. What You Get • Declarative city configuration in • Multiple runtime providers: tmux, subprocess, exec, ACP, and Kubernetes • Beads-backed work tracking, formulas, molecules, waits, and mail • A controller/supervisor loop that reconciles desired state to running state • Packs, overrides, and rig-scoped orchestration for multi-project setups Quickstart See the full install guide at docs/getting-started/installation.md. Prerequisites Gas City requires the following tools on your system. and check for these automatically and report any that are missing. | Dependency | Required | Min Version | Install (macOS) | Install (Linux) | |------------|----------|-------------|-----------------|-----------------| | tmux | Always | — | | | | git | Always | — | | | | jq | Always | — | | | | pgrep | Always | — | (included in macOS) | | | lsof | Always | — | (included in macOS) | | | dolt | Beads provider | 1.80.0 | | releases | | bd | Beads provider | 0.61.0 | releases | releases | | flock | Beads provider | — | | | | claude / codex / gemini | Per provider | — | See provider docs | See provider docs | The (beads) provider is the default. To use a file-based store instead (no dolt/bd/flock needed), set or add to your . Install from Homebrew: Or build from source: For the longer walkthrough, start with Tutorial 01. Documentation The docs now use a Mintlify structure rooted in . • Docs Home • Installation • Quickstart • Repository Map • Contributors • Reference • Architecture • Design Docs • Archive Preview the docs locally: Repository Map • : CLI commands, controller wiring, and supervisor integration • : runtime provider abstraction and implementations • : schema, pack composition, and validation • : store abstraction and provider implementations • : session bead metadata and wait helpers • : periodic formula and exec dispatch • : bounded iterative refinement loops • : sample cities, packs, formulas, and configs • : helper scripts and deployment assets • : integration and support test packages Contributing Read CONTRIBUTING.md and docs/contributors/index.md before opening a PR. Useful commands: • • • • License MIT