Skip to main content

​
CLI Commands

Complete reference for all Gump commands.

​
gump run

Execute a workflow. 
gump run <workflow> --spec <file>
FlagDescription
--spec <file>Spec file to pass to the workflow
--dry-runShow execution plan without running agents
--verboseShow detailed per-turn events
--pause-after <step>Pause after a specific step (HITL)
--replay --from-step <id>Replay from a clean state at a specific step
--resumeResume a crashed or paused run
--run <uuid>Target a specific run (with —resume)
Examples: 
# Standard run
gump run implement-spec --spec spec.md

# Preview without executing
gump run cheap2sota --spec spec.md --dry-run

# Verbose output
gump run tdd --spec spec.md --verbose

# Resume after a crash
gump run --resume

# Replay a step
gump run --replay --from-step impl

​
gump apply

Merge the run result into your current branch. 
gump apply [--run <uuid>]

​
gump status

Show the state of a run in progress. 
gump status

​
gump report

View run metrics. 
gump report [--last N]
gump report <run-uuid> --detail <step>

​
gump playbook

Manage workflows. 
gump playbook list
gump playbook show <name>

​
gump models

List supported agents and their availability. 
gump models

​
gump doctor

Check your environment. 
gump doctor

​
gump config

View and modify configuration. 
gump config
gump config set <key> <value>

​
gump gc

Garbage collection. 
gump gc [--keep-last N]