quickstart.md

title	Quickstart
description	Create a city, add a rig, and route work in a few minutes.

This guide assumes you have already installed Gas City and its prerequisites. If you haven't, start with the [Installation](/getting-started/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).

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
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.