Skip to main content

Command reference

Workspace management​

gt install <path>              # Initialize workspace
gt rig add <name> <repo>       # Add project
gt rig list                    # List projects
gt crew add <name> --rig <rig> # Create crew workspace

Agent operations​

gt agents                      # List active agents
gt sling <bead-id> <rig>       # Assign work to agent
gt sling <bead-id> <rig> --agent cursor  # Override runtime for this sling

gt mayor attach                # Start Mayor session
gt mayor start --agent auggie  # Start Mayor with agent alias
gt prime                       # Recover context in an existing session

Built-in agent presets: claude, gemini, codex, cursor, auggie, amp.

Convoy tracking​

gt convoy create <name> [issues...]     # Create convoy with issues
gt convoy list                          # List all convoys
gt convoy show [id]                     # Show convoy details
gt convoy add <convoy-id> <issue-id...> # Add issues to convoy

Configuration​

# Set custom agent command
gt config agent set claude-glm "claude-glm --model glm-4"

# Set default agent
gt config default-agent claude-glm

# View config
gt config show

Beads integration​

bd formula list  # List formulas
bd cook <formula>
bd mol pour <formula>
bd mol list