Skip to main content

Settings reference

Open Knox: Open Knox Settings for a grouped picker (editor assist, agent, verification, memory, network, checkpoints), then the filtered Settings UI. Chat gear is Knox: Settings (models and agent knobs — not recipe knobs). IDs stay knoxchat.* / knox.* so old settings.json and keybindings keep working.

Values below match KnoxCoder 2.2.2 package.json. Search @id:knoxchat in Settings.

Agent​

SettingDefaultEffect
knoxchat.agentProfiledefaultdefault / systems / rust / auto — profiles
knoxchat.permissionDefaultunsetOverride new-session heuristic (auto / ask / edits)
knoxchat.trustedGitRemotes[]Remote URL substrings that keep new sessions in Auto
knoxchat.fallbackModel""Model title after repeated transient stream failures
knoxchat.deferToolstrueCore catalog + builtin_tool_search
knoxchat.enableCompositeToolsfalseExpose composite_*
knoxchat.enablePostEditVerificationtrueLSP fixes after mutating tools; ignored on systems/rust or when verifyCommand is set
knoxchat.verifyCommand""Compile oracle
knoxchat.verifyModediagnosticsdiagnostics / command / off
knoxchat.verifyMaxIterations8Identical compiler-error circuit breaker (1–20)
knoxchat.compatInstructions[]cursor and/or copilot extra instruction files
knoxchat.jev.enabledtrueJev / System One
knoxchat.jev.showStatusBartrueStatus bar + log

Memory and recipes​

SettingDefaultEffect
knoxchat.memoryBrain.enabledtrueGlobal Memory Brain
knoxchat.memoryBrain.workspaceEnabledtrueThis folder
knoxchat.memoryBrain.maxBytes268435456sqlite + WAL cap (256 MB). 0 disables. KNOX_BRAIN_MAX_BYTES overrides
knoxchat.recipes.enabledfalseCapture verified mutating work
knoxchat.recipes.autoReplayoffoff / ask / exact
knoxchat.selfImprove.enabledfalseLocal proposals; nothing posted

Recipe switches live on Memory → Settings, not the chat gear.

Network​

SettingDefaultEffect
knoxchat.networkModeallowbuiltin_fetch_url: allow / deny / allowlist. KNOX_NETWORK_MODE overrides
knoxchat.networkAllowlist[]Hosts when mode is allowlist. KNOX_NETWORK_ALLOWLIST comma-separated

Does not block model HTTP. Network and offline.

Edit assist​

SettingDefaultEffect
knoxchat.showInlineTiptrueShortcut tips (⌘L / ⌘I)
knoxchat.enableInlineCompletionsfalseGhost-text completions. Stay off in 2.2 — no FIM model. Assist is Cmd+I, Apply from chat, review-before-edit
knoxchat.inlineCompletionModel""Unused unless you turn ghost-text on
knoxchat.editAssist.codeLenstrueCodeLens on empty files, stubs, TODOs, errors — same path as Cmd+I
knoxchat.editAssist.nextEdittrueAfter Accept, one related reviewable edit; never while you type
knoxchat.enableShadowPreviewfalseSide-by-side shadow diff before applying a chat edit
knoxchat.shadowPreviewLargeFilesfalseAllow shadow preview on files over 4000 lines
knoxchat.disableQuickFixfalseDisable quick fix
knoxchat.enableQuickActionsfalseExtra quick actions

Checkpoints (selected)​

SettingDefaultEffect
knox.checkpoints.maxCheckpoints1000Engine retention (+ pins)
knox.checkpoints.maxFileSizeBytes52428805 MB per file
knox.checkpoints.maxStorageBytes10000000001 GB
knox.checkpoints.enableAutoCheckpointstrueAfter AI turns that changed files
knox.checkpoints.auto.enabledtrueTime / file-threshold autos
knox.checkpoints.encryptAtRestfalseAES-GCM blobs; key in Secret Storage
knox.checkpoints.smart.maxCheckpoints50Ignored (deprecated)

Full checkpoint keys: search @id:knox.checkpoints or the Configuration tab on the Checkpoint Graph.

Deprecated no-ops (ignored)​

SettingWhy it is still in Settings
knoxchat.sandboxOS sandbox removed in 2.0. Shell uses command guard + prompts
knoxchat.sharedLoopAgent chat always uses the shared loop
knox.checkpoints.smart.maxCheckpointsSmart create uses knox.checkpoints.maxCheckpoints

Old settings.json still loads. Changing these does nothing.

Next​

Keyboard shortcuts · Command palette · Network and offline