Environment Variables
Every KANNA_* env var Kanna reads, auto-extracted from source.
| Variable | Default | Description |
|---|---|---|
KANNA_CLAUDE_DRIVER | sdk | Driver mode: "sdk" (API rates) or "pty" (subscription billing, macOS/Linux only). |
KANNA_CLAUDE_SESSION_IDLE_MS | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_CLAUDE_SESSION_MAX_RESIDENT | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_CLAUDE_SESSION_SWEEP_INTERVAL_MS | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_DISABLE_SELF_UPDATE | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_LOG_ANALYTICS | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_LOG_CLAUDE_STEER | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_MCP_TOOL_CALLBACKS | 0 | Set to "1" to route AskUserQuestion / ExitPlanMode / built-in shims through the durable approval protocol. |
KANNA_PROFILE_SEND_TO_STARTING | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_PTY_E2E | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_RELOADER | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_REPO_DIR | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_RUNTIME_PROFILE | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_RUN_LIVE_TITLE_TESTS | (undocumented) | (no description — add one to extract-env-vars.ts DESCRIPTIONS) |
KANNA_SERVER_SECRET | (random per process) | Stabilises HMAC tool-request ids across process restarts. |
To regenerate this table after adding a new env var:
cd wiki && bun run scripts/extract-env-vars.tsHand-curated descriptions live in wiki/scripts/extract-env-vars.ts under DESCRIPTIONS. Vars with no description are flagged in the table.