Skip to main content

Configuration

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

Configuration cascade

Project config (gump.toml)

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

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