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.

​
Configuration

Gump configuration follows a cascade: environment variables override user config, which overrides project config, which overrides defaults.

​
Configuration cascade

PrioritySourceLocation
1 (highest)Environment variablesGUMP_* prefix
2User config~/.gump/config.toml
3Project configgump.toml at repo root
4 (lowest)DefaultsBuilt into Gump

​
Project config (gump.toml)

default_agent = "claude-sonnet"
log_level = "info"

[display]
verbose = false

[validation]
compile_cmd = "make build-affected"
test_cmd = "make test-unit"
lint_cmd = "golangci-lint run --timeout 5m"

[budget]
max_budget = 10.00

[error_context]
max_error_chars = 2000
max_diff_chars = 3000

[analytics]
enabled = true

​
All settings

​
default_agent

Agent used when a step doesn’t specify one. Default: "claude-sonnet"

​
log_level

Values: debug, info, warn, error. Default: "info"

​
validation.compile_cmd / test_cmd / lint_cmd

Shell commands for gates. Override heuristic detection. Not overridable via env vars.

​
budget.max_budget

Default max cost per run in USD. Overridable per workflow with max_budget YAML field.

​
error_context.max_error_chars / max_diff_chars

Truncation limits for {error} (default 2000) and {diff} (default 3000) on retry. Smart truncation: first and last lines preserved for compile errors, context around changes preserved for diffs.

​
analytics.enabled

Anonymous telemetry. Default: true. See Privacy & Telemetry.

​
Viewing active configuration

gump config
Each value shows its source (default, user config, project config, env var).