GAS TOWN COMMAND MAP
GAS TOWN 1.1.0 • OPERATOR MAP

Run the town. Not the agents.

Gas Town turns a shared codebase into a durable multi-agent operation. You set the destination. The Mayor, Convoys, Beads, Polecats, supervisors, and Refinery keep work moving.

Learn the core loopSearch all commands

The delivery railway

Mike or Hermesobjective enters town
Mayorplans Convoy + Beads
Polecatswork in isolated worktrees
Refineryverifies + merges
Evidence returnsstatus, proof, blockers
Witness + Deacon + Dogs guard the tracks.
01 • DAILY LOOP

Five moves worth memorizing.

Everything else is searchable. Start read-only, dispatch deliberately, and let the Refinery own merge readiness.

1

Inspect

gt status

See the town before changing it.

2

Choose work

gt ready

Find work that can move now.

3

Dispatch

gt sling

Assign one Bead through the native path.

4

Watch

gt trail

Follow activity without interrupting workers.

5

Finish

gt done

Send verified work toward the merge queue.

02 • WHO OWNS WHAT

Native roles beat custom plumbing.

Do not build a second task runner. Each Gas Town role already has a clear job.

gt mayor

Mayor

Chief of Staff for objectives, decomposition, and cross-rig coordination.

gt convoy

Convoy

A delivery grouping multiple durable Beads.

gt bead

Bead

One durable, structured unit of work.

gt polecat

Polecat

Persistent worker identity with ephemeral sessions and isolated worktrees.

gt hook

Hook

Assignment, notes, and handoff state that survive sessions.

gt witness

Witness

Per-rig worker health and lifecycle supervision.

gt deacon

Deacon + Dogs

Town-wide watchdog and dispatched infrastructure recovery.

gt refinery

Refinery

Quality verification and merge-queue processing.

03 • WHEN THINGS STICK

Diagnose before you restart.

Use the smallest recovery command that matches the failure. Emergency controls change the whole town.

Need context?

gt resume
gt seance

Recover handoffs and predecessor-session knowledge.

Work is stuck?

gt orphans
gt release
gt doctor

Find lost work, release stale issues, then inspect workspace health.

Real emergency?

gt estop
gt thaw

Freeze or resume all work. These are town-wide state changes.

04 • COMPLETE COMMAND CATALOG

Search all 109 commands.

Generated from the locally installed `gt help` for version 1.1.0. Use `gt [command] --help` before version-sensitive operations.

Keep the core commands beside your keyboard.

The ready-made PDF includes the daily loop and essential operator commands.

Download PDF