Reference
Files & config
The .wisdom/ folder, Wisdom's git refs, wisdom-team.json, .wisdomignore, environment variables and ports.
Everything Wisdom stores, and the few settings you can change. Most projects never need any of them.
The .wisdom/ folder
Section titled “The .wisdom/ folder”wisdom.json marks the projectdaemon.json the running service: port, process ID, tokendaemon.log, dashboard.logledger.sqlite every record (SQLite is the source of truth)spool/<agent>/<session>/ events kept while the service was downdeleted.json hashes that keep deleted sessions outbackups/<time>/ files a dashboard repair changed, as they wereshared/ sessions imported from teammates, read-onlyshared-out/ files written by share and exportconfig.json your guide setting, from wisdom guide on|offrecorder.json a random ID that names your sessions in team modejobs/ a commit's record and guide job, while it runsjobs.log one line per commit job: guide writer, seconds, costteam-imports.json teammates' sessions fetched by wisdom team fetchharnesses/<agent>/home/ a tracked agent's home: settings, login, sessionsharnesses/<agent>/<session-id>/ native-session.jsonl the agent's transcript, byte for byte subagents/agent-<id>.jsonl Claude Code subagent transcripts payloads/<sha256> tool inputs, outputs and diffsTo back it up, stop the service first (wisdom daemon stop) and copy the whole folder. Never
copy ledger.sqlite alone while it runs.
Inside .git
Section titled “Inside .git”Commit records live in your repository as hidden refs. They’re never on a branch, never checked
out, and a normal git push or git clone doesn’t carry them.
records/<commit> a commit's record and guidesessions/<recorder>/<session> your pushed sessions, one version per push (team mode)deleted the team's deletion list (team mode)In team mode, the remote holds the same under refs/wisdom/<repo-id>/. git push --mirror
sends every ref, these included. See Read a commit and
Share with your team.
wisdom-team.json
Section titled “wisdom-team.json”A committed wisdom-team.json at the top of the repository turns on team mode.
wisdom team init writes it:
{ "version": 1, "repoId": "5d0c3c1e-8a5b-4b8e-9d0e-2f1c7a3b9e11", "remote": "origin", "identity": true, "requireGuides": true, "keepReferenced": true}| Field | Default | What it does |
|---|---|---|
repoId |
made by team init |
Names this repository’s refs on the remote, so one remote can hold several repositories’ sessions. |
remote |
origin |
Where sessions and records go. --remote NAME overrides it for one command. |
identity |
true |
Each pushed session carries the recorder’s git name and email, labelled “git config”. |
requireGuides |
true |
wisdom check fails a commit with agent work and no guide that passed Wisdom’s check. |
retentionDays |
none | wisdom team prune removes pushed sessions older than this. |
keepReferenced |
true |
prune keeps sessions a pushed commit record still names. |
check |
none | Your own command, run on each session file before it’s pushed, with the file’s path last. It may change the file; a non-zero exit keeps that session home, and it’s tried again at the next push. |
guides.model |
claude-haiku-5-5 |
The model that writes guides. |
guides.command |
Claude Code | Any other writer. It reads the prompt on stdin, prints the guide, and finds the model in WISDOM_GUIDE_MODEL. It gets the cited steps already opened and can’t read further. |
.wisdomignore
Section titled “.wisdomignore”Files Wisdom shouldn’t diff, one relative path or folder per line, # for comments. No globs,
no negation.
src/generated/fixtures/large-dump.jsonAlways skipped: .git, .wisdom, node_modules, dist, build, .next, .venv,
__pycache__, .npm-cache, and symlinks.
Environment variables
Section titled “Environment variables”| Variable | What it does |
|---|---|
WISDOM_DATA_DIR |
Use this data folder, the same as --data. |
NO_COLOR |
Print glance and open without colour, as with --plain. |
| Port | Used by |
|---|---|
127.0.0.1:7434 |
The background service |
127.0.0.1:7435 |
The dashboard |
When another project’s service holds them, Wisdom takes the next free pair (7436 and 7437,
and so on). wisdom daemon start --port N asks for one port exactly. Both listen only on your
own machine.
Limits
Section titled “Limits”| Limit | Value |
|---|---|
One glance or open answer |
80,000 characters, then limited with a way to continue |
| A single line | 2,000 characters, then split, marked ⤷ |
| A file Wisdom diffs | 1 MiB |
| Files watched in a project | 10,000, and 64 MiB in total |
| Idle time before a session closes | 10 minutes |