Skip to main content

config.toml Reference

Located at ~/.nimbus/config.toml. Created automatically with defaults on first run.

Full example

[local]
chroma_dir = "~/.nimbus/chroma"
default_model_planner = "claude-opus-4-6"
default_model_implementer = "claude-sonnet-4-6"
editor = ""
sound = false
auto_approve_confidence = 92
watch_debounce_seconds = 30
pair_debounce_seconds = 3

Key reference

KeyTypeDefaultDescription
chroma_dirpath~/.nimbus/chromaChromaDB persistence directory for local mode
default_model_plannerstringclaude-opus-4-6Claude model for the planning phase
default_model_implementerstringclaude-sonnet-4-6Claude model for the implementation phase
editorstring""Text editor to open when you press e at the plan approval prompt. Leave empty to disable. Example: "vim", "code --wait"
soundbooleanfalseEnable audio cues. Requires afplay (macOS) or aplay (Linux).
auto_approve_confidenceinteger92Confidence threshold (0–100) above which the plan approval prompt is skipped. Set to 100 to always be prompted.
watch_debounce_secondsinteger30Seconds to wait after a file change before analyzing in nimbus watch.
pair_debounce_secondsinteger3Seconds to wait after a file save before analyzing in nimbus pair.

Notes

  • All paths support ~ expansion.
  • Model values must be valid Claude model IDs. See console.anthropic.com for available models.
  • Changes to config.toml take effect immediately on the next REPL command — you don't need to restart Nimbus.