Skip to main content

​
CLI Commands

Complete reference for all Gump commands.

​
gump run

Execute a workflow. 
gump run <spec-file> --workflow <name>
FlagDescription
--workflow <name>Workflow to run (required)
--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)
--log-level <level>Override log level (debug, info, warn, error)
Examples: 
# Standard run
gump run spec.md --workflow tdd

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

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

# Resume after a crash
gump run --resume

# Replay a step with a new strategy
gump run --replay --from-step impl

​
gump apply

Merge the run result into your current branch. 
gump apply [--run <uuid>]
Performs a git merge from the run’s branch into your working branch. Adds a Gump-Run: <uuid> trailer to the commit. Without --run, applies the most recent successful run.

​
gump status

Show the state of a run in progress. 
gump status
Displays the current step, elapsed time, cost so far, and agent activity.

​
gump report

View run metrics. 
gump report [--last N] [--detail <step>]
FlagDescription
(no flag)Report for the most recent run
--last NSummary table of the last N runs
--detail <step>Detailed view of a specific step (attempts, state bag, files)

​
gump playbook

Manage workflows. 
gump playbook list
gump playbook show <name>
list shows all available workflows (built-in + project + user) with names, descriptions, and sources. show prints the full YAML of a workflow. Useful for copying and customizing.

​
gump models

List supported agents and their availability. 
gump models
Shows each agent, whether its CLI is installed, and the detected version.

​
gump doctor

Check your environment. 
gump doctor
Verifies: Git is installed, config is loadable, workflows parse correctly, and which agent CLIs are available.

​
gump config

View and modify configuration. 
gump config
gump config set <key> <value>
Without arguments, shows the active configuration with the source of each value (default, user config, project config, environment variable). set writes to the user config (~/.gump/config.toml). Use gump.toml in your project root for project-specific settings.

​
gump gc

Garbage collection. 
gump gc [--keep-last N]
Removes old worktrees, branches, and run artifacts. Default keeps the last 10 runs. Unapplied runs prompt for confirmation.

​
Global flags

FlagDescription
--log-level <level>Log verbosity: debug, info, warn, error
--versionPrint Gump version
--helpShow help for any command