Configuration

Configuration file

Configuration lives in .ody/ody.json in your project root. A global configuration can also be placed at ~/.ody/ody.json or ~/.config/ody/ody.json. When both exist, local (project-level) settings override global ones.

Config keys

Example configuration

{
  "backend": "claude",
  "maxIterations": 5,
  "autoCommit": true,
  "validatorCommands": ["bun lint", "bun fmt", "bun typecheck"],
  "model": "claude-sonnet-4-20250514"
}

Config resolution

ody resolves configuration in the following order:

1. Global config -- ~/.ody/ody.json or ~/.config/ody/ody.json (checked in that order)
2. Local config -- .ody/ody.json in the current project

Local settings are merged on top of global settings, so you can set shared defaults globally and override them per-project.