Configuration Keys
Configuration Keys
Heimdall organizes config into namespaces — one per tool, plus a shared
ai namespace.
odin
Desktop app configuration.
| Key | Type | Default | Description |
|---|---|---|---|
database_path |
path | (empty) | Path to Odin SQLite DB |
backup_path |
path | (empty) | Path for database backups |
theme |
string | "system" |
UI theme |
auto_backup |
boolean | "true" |
Enable automatic backups |
ai
Cross-cutting AI configuration. Disabled by default — opt-in per user.
| Key | Type | Default | Description |
|---|---|---|---|
enabled |
boolean | "false" |
Master AI enable/disable switch |
provider |
enum | (empty) | AI provider: anthropic, openai |
api_key |
secret | (empty) | API key (masked in CLI output) |
odin_access |
array | "[]" |
Modules AI can access in Odin |
Schema Types
| Type | Validation | Display |
|---|---|---|
string |
Any text | Plaintext |
path |
Any text (semantic hint for file paths) | Plaintext |
secret |
Any text | Masked |
number |
Must parse as float64 | Plaintext |
boolean |
"true" or "false" only |
Plaintext |
array |
Must be valid JSON array | Plaintext |
enum |
Must be in the schema’s allowed choices | Plaintext |
Change History
Every Set and Reset operation records a history entry in the
config_history table with the old value, new value, who changed it, and when.
This is useful for auditing and debugging configuration drift.