// generated reference · 07
Navigable configuration schema
Structured view of real okami.yaml keys: inferred type, default, operational risk and role. Use it as a checklist before publishing examples or hardening production.
| key | type | default | risk | role |
|---|---|---|---|---|
default_provider | string | lmstudio | runtime | Provider used when no provider is specified by the command. |
memory | map | - | normal | Key loaded from the base okami.yaml. |
memory.backend | string | sqlite-fts5 | normal | Memory, embeddings, identity files and backend configuration. |
memory.global | bool | true | normal | Memory, embeddings, identity files and backend configuration. |
memory.embedder | map | - | normal | Memory, embeddings, identity files and backend configuration. |
memory.embedder.enabled | bool | true | normal | Memory, embeddings, identity files and backend configuration. |
memory.embedder.api_base | string | http://localhost:4480/v1 | normal | Memory, embeddings, identity files and backend configuration. |
memory.embedder.model | string | text-embedding-nomic-embed-text-v1.5 | runtime | Memory, embeddings, identity files and backend configuration. |
memory.holographic | map | - | normal | Memory, embeddings, identity files and backend configuration. |
memory.holographic.dim | int | 1024 | normal | Memory, embeddings, identity files and backend configuration. |
memory.files | map | - | normal | Memory, embeddings, identity files and backend configuration. |
memory.files.soul | int | 6000 | normal | Memory, embeddings, identity files and backend configuration. |
memory.files.voice | int | 6000 | normal | Memory, embeddings, identity files and backend configuration. |
memory.files.persona | int | 6000 | normal | Memory, embeddings, identity files and backend configuration. |
memory.files.agents | int | 4000 | normal | Memory, embeddings, identity files and backend configuration. |
memory.files.user | int | 4000 | normal | Memory, embeddings, identity files and backend configuration. |
memory.files.memory | int | 4000 | normal | Memory, embeddings, identity files and backend configuration. |
contracts | map | - | normal | Key loaded from the base okami.yaml. |
contracts.ui | map | - | normal | Verifiable UI and design-system contract. |
contracts.ui.library | string | shadcn | normal | Verifiable UI and design-system contract. |
contracts.ui.component_source | string | '@/components/ui' | normal | Verifiable UI and design-system contract. |
contracts.ui.forbid_inline_hex | bool | true | security | Verifiable UI and design-system contract. |
contracts.ui.forbid_raw_css | bool | true | security | Verifiable UI and design-system contract. |
contracts.ui.require_component_source | bool | true | normal | Verifiable UI and design-system contract. |
learning | string | source comment | normal | Key loaded from the base okami.yaml. |
review | bool | false | normal | Key loaded from the base okami.yaml. |
review_interval | int | 6 | normal | Key loaded from the base okami.yaml. |
auto_skill | bool | false | normal | Key loaded from the base okami.yaml. |
auto_tune | bool | true | normal | Key loaded from the base okami.yaml. |
retention | string | source comment | ops | Key loaded from the base okami.yaml. |
sessions | inline map | {days: 30, keep: 10} | ops | Key loaded from the base okami.yaml. |
checkpoints | inline map | {days: 14, keep: 50} | ops | Key loaded from the base okami.yaml. |
tool_outputs | inline map | {days: 7, keep: 200} | ops | Key loaded from the base okami.yaml. |
processes | inline map | {ttl_hours: 24} | normal | Key loaded from the base okami.yaml. |
audio | inline map | {enabled: true} | normal | Key loaded from the base okami.yaml. |
quota_mb | inline map | {tool_outputs: 500, checkpoints: 200, sessions: 200} | ops | Key loaded from the base okami.yaml. |
gateway | string | source comment | security | Key loaded from the base okami.yaml. |
reactions | bool | true | normal | Key loaded from the base okami.yaml. |
voice | string | source comment | normal | Key loaded from the base okami.yaml. |
stt | map | - | normal | Key loaded from the base okami.yaml. |
stt.backend | string | whisper | normal | Key loaded from the base okami.yaml. |
stt.model | string | small | runtime | Key loaded from the base okami.yaml. |
tts | map | - | normal | Key loaded from the base okami.yaml. |
tts.enabled | bool | true | normal | Key loaded from the base okami.yaml. |
tts.backend | string | edge | normal | Key loaded from the base okami.yaml. |
tts.voice | string | pt-BR-AntonioNeural | normal | Key loaded from the base okami.yaml. |
providers | map | - | runtime | Key loaded from the base okami.yaml. |
providers.lmstudio | map | - | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.lmstudio.model | string | openai/qwen3.5-4b-mtp | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.lmstudio.api_base | string | http://localhost:4480/v1 | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.lmstudio.api_key | string | lm-studio | secret | Provider, auth, transport, fallback, model and context-window configuration. |
providers.lmstudio.auth | string | api_key | secret | Provider, auth, transport, fallback, model and context-window configuration. |
providers.lmstudio.tier | string | local | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.lmstudio.context_window | int | 32768 | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.lmstudio.capability | map | - | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.lmstudio.capability.tool_mode | string | json_constrained | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.lmstudio.models | map | - | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.lmstudio.notes | string | List models with okami doctor; change the model as needed. | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.codex | map | - | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.codex.model | string | openai-codex/gpt-5.5 | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.codex.fallback | list | [claude, minimax, lmstudio] | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.codex.auth | string | oauth_subscription | secret | Provider, auth, transport, fallback, model and context-window configuration. |
providers.codex.transport | string | codex_oauth | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.codex.tier | string | strong | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.codex.context_window | int | 256000 | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.codex.reasoning_effort | string | high | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.codex.models | map | - | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.codex.notes | string | Login with okami login codex using device flow. | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.claude | map | - | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.claude.model | string | claude-subscription/claude-opus-4-8 | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.claude.fallback | list | [codex, minimax, lmstudio] | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.claude.auth | string | oauth_subscription | secret | Provider, auth, transport, fallback, model and context-window configuration. |
providers.claude.transport | string | claude_cli | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.claude.tier | string | strong | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.claude.context_window | int | 200000 | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.claude.models | map | - | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.claude.notes | string | Uses the claude CLI for subscription/OAuth refresh. | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.minimax | string | source comment | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.model | string | openai/MiniMax-M3 | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
providers.fallback | list | [codex, claude, lmstudio] | runtime | Provider, auth, transport, fallback, model and context-window configuration. |
Showing 80 of 105 rows. Open the interactive docs for the complete table.