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

# Configuration

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

## Configuration cascade

| Priority    | Source                | Location                 |
| ----------- | --------------------- | ------------------------ |
| 1 (highest) | Environment variables | `GUMP_*` prefix          |
| 2           | User config           | `~/.gump/config.toml`    |
| 3           | Project config        | `gump.toml` at repo root |
| 4 (lowest)  | Defaults              | Built into Gump          |

## Project config (gump.toml)

```toml theme={null}
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

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

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