Configuration Reference
Konductor reads configuration from .konductor/config.toml. All fields have sensible defaults — the file is optional.
[general]
| Field | Type | Default | Description |
|---|---|---|---|
default_model |
string | "claude-sonnet-4" |
The AI model used by subagents |
[execution]
| Field | Type | Default | Description |
|---|---|---|---|
max_wave_parallelism |
integer | 4 |
Maximum number of plans to execute simultaneously within a wave. Set to 1 for sequential execution. |
[git]
| Field | Type | Default | Description |
|---|---|---|---|
auto_commit |
boolean | true |
Automatically commit after each task completes |
branching_strategy |
string | "none" |
Branch strategy: "none" (commit to current branch) or "feature" (create feature branches per plan) |
[features]
Feature flags to enable or disable pipeline stages.
| Field | Type | Default | Description |
|---|---|---|---|
research |
boolean | true |
Run ecosystem research before planning |
plan_checker |
boolean | true |
Validate plans after creation (coverage, sizing, dependencies) |
design_review |
boolean | true |
Run design review after planning with user approval gate |
code_review |
boolean | true |
Run automated code review after execution |
verifier |
boolean | true |
Run 3-level verification after execution |
[features]
research = true
plan_checker = true
design_review = true
code_review = true
verifier = true
Tip
Set verifier = false to skip verification and move directly from executed to complete. Useful for rapid iteration.
Tip
Set design_review = false to skip the design review and user approval gate during planning. Plans will be marked as "planned" immediately after validation.
Tip
Set code_review = false to skip automated code review after execution. Useful when you want faster iteration and will review code manually.
[hooks]
Configure steering hook behavior.
| Field | Type | Default | Description |
|---|---|---|---|
test_patterns |
string[] | (see below) | Patterns matched against shell commands to detect test/lint runs. Used by the test-before-complete workflow rule. |
Default test patterns:
[hooks]
test_patterns = [
"test", "pytest", "cargo test", "npm test", "npx test",
"go test", "mvn test", "gradle test", "gradlew test",
"jest", "vitest", "mocha", "junit",
"ruff", "lint", "eslint", "golangci-lint", "checkstyle", "clippy",
]
Setting test_patterns completely replaces the defaults. Patterns are matched case-insensitively as substrings of the shell command.
Complete Example
[general]
default_model = "claude-sonnet-4"
[execution]
max_wave_parallelism = 4
[git]
auto_commit = true
branching_strategy = "none"
[features]
research = true
plan_checker = true
design_review = true
code_review = true
verifier = true
[hooks]
test_patterns = ["test", "pytest", "cargo test", "npm test", "go test", "mvn test", "lint", "clippy"]
Defaults
If .konductor/config.toml doesn't exist, all defaults are used. If the file exists but is missing sections, the missing sections use defaults. This means a minimal config like:
...will use defaults for everything except max_wave_parallelism.