home
Town
Your workspace directory (e.g., ~/gt/). Contains all rigs, agents, and configuration.
folder_special
Rig
A git project container with its own agents. Each rig has a Witness (monitor) and optional Refinery (merge queue).
local_shipping
Convoy
A group of related work items (issues/beads). Convoys track progress across multiple tasks.
send
Sling
Assign work to a worker agent. "Sling" a bead/issue to a polecat to start work.
anchor
Hook
Where work "hangs" on an agent. On wake, agents run what's on their hook. Work survives crashes.
bubble_chart
Bead
A work item in the git-backed issue tracker. Beads persist in your repo and track all work state.
science
Formula / Molecule
Workflow templates. Cook a formula into a molecule, then sling it. Molecules survive agent restarts.
Global coordinator for cross-rig work. Dispatches tasks, handles escalations, manages priorities across all projects.
Daemon process manager. Handles agent lifecycle, plugin execution, and system-level coordination.
Per-rig monitor. Watches polecats, detects stuck workers, handles lifecycle events. One per project.
Merge queue processor. Reviews PRs, runs integration tests, manages the code review pipeline.
Ephemeral worker agent. Spawns, executes work on its hook, then disappears. Multiple per rig.
Human operator. Sets strategy, reviews output, handles escalations. Uses this GUI to monitor and direct work.
1
Create a Convoy
Group related issues into a convoy for tracking. Give it a name and add issue IDs.
→
2
Sling Work
Assign issues to worker agents (polecats). Select the target rig and quality level.
→
3
Monitor Progress
Watch the convoy dashboard. Workers will update status as they complete tasks.
→
4
Review & Merge
When work completes, Refinery handles PRs. Escalate to Mayor if issues arise.
lightbulb
Pro Tip: Use formulas for repeatable workflows. Cook once, sling many times!
Navigation
1 Convoys view
2 Agents view
3 Mail view
Actions
Ctrl+N New convoy
Ctrl+R Refresh
? This help
GAS TOWN