> ## 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.

# CLI Commands

Complete reference for all Gump commands.

## gump run

Execute a workflow.

```bash theme={null}
gump run <workflow> --spec <file>
```

| Flag                        | Description                                  |
| --------------------------- | -------------------------------------------- |
| `--spec <file>`             | Spec file to pass to the workflow            |
| `--dry-run`                 | Show execution plan without running agents   |
| `--verbose`                 | Show 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 |
| `--resume`                  | Resume a crashed or paused run               |
| `--run <uuid>`              | Target a specific run (with --resume)        |

**Examples:**

```bash theme={null}
# 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.

```bash theme={null}
gump apply [--run <uuid>]
```

## gump status

Show the state of a run in progress.

```bash theme={null}
gump status
```

## gump report

View run metrics.

```bash theme={null}
gump report [--last N]
gump report <run-uuid> --detail <step>
```

## gump playbook

Manage workflows.

```bash theme={null}
gump playbook list
gump playbook show <name>
```

## gump models

List supported agents and their availability.

```bash theme={null}
gump models
```

## gump doctor

Check your environment.

```bash theme={null}
gump doctor
```

## gump config

View and modify configuration.

```bash theme={null}
gump config
gump config set <key> <value>
```

## gump gc

Garbage collection.

```bash theme={null}
gump gc [--keep-last N]
```