Skip to main content
This guide assumes you have already installed Gas City and its prerequisites. If you haven’t, start with the Installation page.
You will need gc, tmux, git, jq, and a beads provider (bd + dolt by default, or set GC_BEADS=file to skip them).
Oh My Zsh’s git plugin defines a gc alias for git commit --verbose. If gc version or gc init opens git commit instead of Gas City, use command gc ... temporarily and remove the alias after Oh My Zsh loads. See Troubleshooting.

​
1. Create a City

gc init bootstraps the city directory, registers it with the supervisor, and starts the orchestrator. The city is running as soon as init completes.

​
2. Add a Rig

A rig is an external project directory registered with the city. It gets its own beads database, hook installation, and routing context.

​
3. Sling Work

gc sling creates a work item (a bead) and routes it to an agent. Gas City starts a session, delivers the task, and the agent executes it. This is the smallest possible job: one bead, one agent. Gas City’s real power is orchestration — you write a formula (the method for getting a job done) and the orchestrator runs it as a graph: decomposing the work into beads, fanning the ready ones out to many agents at once, gating each step on its dependencies, retrying failures, and driving the whole thing to completion outside your session. See Formulas and Orders.

​
4. Watch an Agent Work

For a fuller walkthrough of cities and rigs, continue to Tutorial 01. To see Gas City do the thing it exists for — the orchestrator running a formula as a graph across many agents — jump to Formulas and then Orders, which trigger formulas on a schedule or event.
Last modified on September 27, 2026