Skip to main content

Workflows

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