User Config
Machine-local configuration at ~/.config/kavi/config.toml
The user config file lives at ~/.config/kavi/config.toml. It's created by kavi init --home and holds machine-specific settings like custom binary paths.
Example
version = 1
[runtime]
node_bin = ""
codex_bin = "codex"
claude_bin = "claude"Fields
[runtime]
| Field | Type | Default | Description |
|---|---|---|---|
node_bin | string | "" | Path to Node.js binary. Empty uses system default. |
codex_bin | string | "codex" | Path to Codex CLI binary. |
claude_bin | string | "claude" | Path to Claude CLI binary. |
When to Use Custom Paths
- You have multiple Node.js versions via nvm and want to pin a specific one
- Codex or Claude are installed in non-standard locations
- You want to use a wrapper script around an agent binary
Example with Custom Paths
version = 1
[runtime]
node_bin = "/Users/me/.nvm/versions/node/v25.6.1/bin/node"
codex_bin = "/Users/me/.local/bin/codex"
claude_bin = "/Users/me/.local/bin/claude"Location Override
In restricted environments, override the config directory:
export KAVI_HOME_CONFIG_DIR=/custom/path/kavi