Work Items (Beads)

Everything in Gas City is a bead — tasks, messages, molecules, convoys. The gc bd CLI is the primary interface for bead CRUD.

Rig-scoped beads

Each rig has its own .beads/ database with its own ID prefix (e.g. fe- for frontend, be- for beads). A bead must live in the same database as the agent that will work on it. When you sling a bead to a rig-scoped agent, sling operates on the agent's rig database — so the bead must already exist there. The bead ID prefix tells you which rig it belongs to.

Use gc rig list to see rig names, paths, and prefixes.

Creating work