Workflows
Mayor workflow (recommended)
Commands:
# Attach to Mayor
gt mayor attach
# In Mayor, create convoy and let it orchestrate
gt convoy create "Auth System" gt-x7k2m gt-p9n4q --notify
# Track progress
gt convoy list
Minimal mode (no tmux)
Run individual runtime instances manually while Gas Town tracks state.
gt convoy create "Fix bugs" gt-abc12
# Assign to worker
gt sling gt-abc12 myproject
# Start the runtime in that workspace
claude --resume
# or: codex
# Check progress
gt convoy list
Beads formula workflow
Formulas are TOML-defined workflows stored in .beads/formulas/.
description = "Standard release process"
formula = "release"
version = 1
[vars.version]
description = "The semantic version to release (e.g., 1.2.0)"
required = true
[[steps]]
id = "bump-version"
title = "Bump version"
description = "Run ./scripts/bump-version.sh {{version}}"
Execute a formula:
# List available formulas
bd formula list
# Run a formula with variables
bd cook release --var version=1.2.0
# Create formula instance for tracking
bd mol pour release --var version=1.2.0