Config Options

Complete reference for Candid configuration.

Schema

{
  "tone": "harsh" | "constructive",
  "focus": "security" | "performance" | "architecture" | "edge-case",
  "mergeTargetBranches": ["branch1", "branch2"],
  "exclude": ["pattern1", "pattern2"],
  "commit": boolean,
  "decisionRegister": {
    "enabled": boolean,
    "path": "string",
    "mode": "lookup" | "load"
  }
}

Options

tone

Review tone.

Value	Description
`"harsh"`	Brutal honesty, no sugar-coating
`"constructive"`	Direct but caring feedback

focus

Review focus mode.

Value	Description
`"security"`	Security vulnerabilities
`"performance"`	Performance issues
`"architecture"`	Design patterns
`"edge-case"`	Unhandled scenarios

mergeTargetBranches

Array of branches to compare against. First existing branch is used.

Default: ["main", "stable", "master"]

exclude

Array of glob patterns for files to skip.

Example: ["*.generated.ts", "vendor/*"]

commit

Whether to auto-commit applied fixes.

Default: false

decisionRegister

Configuration for tracking questions and decisions during reviews.

Field	Type	Default	Description
`enabled`	boolean	`false`	Whether to track questions during reviews
`path`	string	`".candid/register"`	Directory for the register file
`mode`	string	`"lookup"`	How the register is consulted: `"lookup"` (per-question check) or `"load"` (full register in context)

Example:

{
  "decisionRegister": {
    "enabled": true,
    "path": ".candid/register",
    "mode": "lookup"
  }
}

See Decision Register for full documentation.

Config Precedence

CLI flags
Project config (.candid/config.json)
User config (~/.candid/config.json)
Interactive prompt