Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gascityhall.com/llms.txt

Use this file to discover all available pages before exploring further.

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 ~/bright-lights
cd ~/bright-lights
gc init bootstraps the city directory, registers it with the supervisor, and starts the controller. The city is running as soon as init completes.

​
2. Add a Rig

mkdir ~/hello-world && cd ~/hello-world && git init && cd -
gc rig add ~/hello-world
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

cd ~/hello-world
gc sling claude "Create a script that prints hello world"
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.

​
4. Watch an Agent Work

bd show <bead-id> --watch
For a fuller walkthrough of the same path, continue to Tutorial 01.
Last modified on May 10, 2026