Skip to main content

Data on disk

Global Knox state is ~/.knoxcoder. Override the whole path with KNOX_GLOBAL_DIR. On Windows: C:\Users\<you>\.knoxcoder.

This is not ~/.knox. Marketplace Knox (knoxchat.knoxchat) owns ~/.knox. KnoxCoder never migrates that folder.

Directory map​

PathContents
config.yamlModels, providers, optional hooks: / context:
config.yaml.vpre-edit.bakOne-time backup when the GUI edits config
auth.jsonKnox OAuth session, mode 0600 (editor also uses SecretStorage)
sessions/Chat transcripts (schemaVersion: 1). Older files copied to <file>.v<N>.bak before rewrite
sessions.jsonSession index (bare array; downgrade still reads it)
brain.sqlite (+ WAL)Memory Brain, graph, recipes. PRAGMA user_version; corrupt → *.corrupt-<ts>
backups/Newest 3 Brain backups before migrate
checkpoints storeByte-exact snapshots; index.json.v<N>.bak before rewrite
skills/User skills
prompts/User slash prompts
agents/User custom agents
registry/owner/Local uses: YAML only
rules/ / .knoxrulesUser rules
.knoxignoreGlobal checkpoint / scan ignore
hooks/ audit logHook runs
logs, job outputDebug and background jobs

Project copies live in the repo: .knoxcoder/, AGENTS.md, skills/, .knoxignore. See Open a folder.

What is redacted where​

DataRedacted?
Tool output in the transcript, logs, Memory Brain writes, exported Markdown, team bundlesyes
Checkpointsno (byte-exact)
Chat messages you typed, at rest in the session fileno (export redacts)

Wipe / export​

  • Knox: Export Memory Brain / Wipe Memory Brain
  • Delete ~/.knoxcoder only if you intend to lose sessions, memory, checkpoints, and login
  • Upgrades keep this directory; see Upgrade

Next​

Privacy · Open a folder · Network and offline