Skip to main content

Privacy

Knox is local-first. Data lives under ~/.knoxcoder (override KNOX_GLOBAL_DIR): config, sessions, Memory Brain sqlite, checkpoints, credentials, job logs. Map: Data on disk.

Knox sends no telemetry, and none is planned (no opt-in usage stats). The VS Code crash reporter is disabled. Issue reports go to github.com/knoxchat/knoxcoder/issues (not Microsoft).

What leaves the machine​

Only what you configured:

  • Model provider — prompts, tool results, images you attach
  • Jev (default on) — user message and tool previews, never file contents — Web and Jev
  • builtin_fetch_url / search_web — if the agent calls them
  • OAuth — if you sign in
  • Auto-update / Open VSX — if you use those surfaces

Network table: Network and offline.

What stays local​

StoreNotes
Memory BrainLocal sqlite. Off switches on the Memory Brain page. Export / wipe from the palette
RecipesLocal sqlite, text redacted, file bytes in checkpoint blobs. Shared only by an explicit checkpoint bundle
CheckpointsByte-exact, not redacted
Session filesUser messages at rest are not redacted; tool output is
Session share linksknoxcoder://vscode.knox/session/import?path= points at a local Markdown file. Knox does not upload transcripts
auth.jsonKnox OAuth session, mode 0600. Editor uses SecretStorage. No KNOX_API_KEY, no .env API key in 2.2

Redaction​

Tool results, logs, prompt logs, Memory Brain writes, exported Markdown, and team bundles run through secret redaction (AWS/GCP/GitHub/Stripe/JWT/PEM/KEY=value / bearer headers, and similar). Checkpoints cannot, or restore would be wrong.

Next​

Threat model · Network · Data on disk