Skip to main content
Gas City is an orchestration-builder SDK for multi-agent systems. This docs tree is organized for external contributors first: install the toolchain, run a local city, find the relevant subsystem, and then decide whether you need current-state architecture docs, forward-looking design docs, or archived working notes.

​
Start Here

  • Installation explains the local toolchain and the shortest path to a working gc binary.
  • Quickstart walks through the smallest city you can boot locally.
  • Coming from Gas Town maps Town roles, commands, plugins, convoys, and filesystem habits onto Gas City’s primitives.
  • Repository Map explains where the CLI, runtime, config, store, and controller code live.
  • Contributors collects the project rules, testing expectations, and codebase map.

​
Documentation Types

  • Tutorials: end-to-end walkthroughs that teach the user model.
  • Guides: practical docs for specific workflows like packs and Kubernetes.
  • Reference: command, config, formula, and provider lookup docs.
  • Architecture: how Gas City works today.
  • Design: proposals, accepted plans, and historical design context.
  • Archive: audits, backlogs, roadmaps, and research notes that should not be mistaken for the current contributor path.

​
Repository Context

Gas City is the open-source SDK extracted from Gas Town. The public docs now separate current contributor guidance from historical planning material so new readers can get oriented without reading every audit and roadmap first.
Last modified on March 20, 2026