Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gump.build/docs/llms.txt

Use this file to discover all available pages before exploring further.

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]