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.

​
Human-in-the-Loop

Sometimes you want to review an agent’s output before the workflow continues. Gump supports pausing a run for human intervention with two positions.

​
hitl: before_gate (default)

Pause after the RUN, before the GATE. You inspect the worktree and decide to continue (the gate runs) or abort. 
- name: decompose
  type: split
  run:
    agent: claude-opus
  hitl: before_gate
  get:
    prompt: "Decompose {spec} into tasks."
  gate: [schema]
hitl: true is an alias for hitl: before_gate.

​
hitl: after_gate

Pause after the GATE, before retry. You see the gate results and decide to continue, abort, or modify the worktree manually. 
- name: impl
  type: code
  run:
    agent: claude-sonnet
  hitl: after_gate
  gate: [compile, test]
  retry:
    - exit: 3

​
—pause-after

Pause after a specific step without modifying the YAML: 
gump run tdd --spec spec.md --pause-after decompose
Same behavior as hitl: before_gate, but from the command line. Useful for debugging or one-off reviews.

​
Manual intervention

While paused, you have full access to the worktree. You can edit files, modify the plan, run your own tests, or delete generated code. When you resume with gump run --resume, Gump picks up from the current worktree state.

​
When to use HITL

HITL is most valuable on the decompose/split step — the plan determines everything that follows. A bad decomposition leads to wasted agent work. Validating the plan manually before agents start building is the highest-leverage intervention point.