The intent behind every change your coding agent makes
Wisdom records Claude Code, Codex and Pi sessions on your machine and links every file change to the request and the commands behind it. You read them in a dashboard; your agents read them through a skill.
Record your first session
Section titled “Record your first session”npm install -g @oqura/wisdomcd your-projectwisdom connectclaude # or codex, or pi: use it as usualThen read what happened: the session at a glance, then any turn in full, or start from the commit it made. Below is an example session, written to show the format.
❯ wisdom glance latestsession 3f9c2a71-8d4e-4b1a-9c55-2e7f0b6d1a90 · claude-code 2.1.319 · closed (idle) · version 412resume with: wisdom resume 3f9c2a71-8d4e-4b1a-9c55-2e7f0b6d1a90workspace /home/maya/invoice-apistarted 2026-11-11 09:12Z · ended 2026-11-11 09:41Z3 turns · 14 tool calls · 1 failed · 3 changes · 0 subagents · 412,906 tokens · $1.8420 reported
t1 in totals are off by a cent on some invoices, find out why out Each line item is rounded before the sum, so cents drift on long invoices. 6 tool calls · no changes
t2 in fix it and add a test out Totals now round once, after the sum. A new test covers a 40-line invoice. 7 tool calls · 1 failed · changed src/totals.ts, test/totals.test.ts
t3 in commit it out Committed as a4c91e2 "fix: round invoice totals once". 1 tool call · no changes
complete · 17 lines❯ wisdom open t2 --capture latestt2 · session 3f9c2a71 · version 412 · 168,204 tokensin fix it and add a test
thinking redacted · 2.1 s (it happened; its text was not recorded)
c1 Edit src/totals.ts · ok · 12 ms · → p1 input and output repeat p1 · open t2/c1 to read them
c2 Write test/totals.test.ts · ok · 9 ms · → p2 input and output repeat p2 · open t2/c2 to read them
c3 Bash · failed · 1.8 s input {"command":"npm test -- totals"} output ✖ rounds a 40-line invoice once (2.1 ms) expected 1204.37, received 1204.35
c4 Edit src/totals.ts · ok · 10 ms · → p3 input and output repeat p3 · open t2/c4 to read them
c5 Bash · ok · 1.6 s input {"command":"npm test -- totals"} output ✔ rounds a 40-line invoice once (1.9 ms)
reply Totals now round once, after the sum. A new test covers a 40-line invoice.
p1 src/totals.ts · modify · +2 −2 · observed during c1 --- src/totals.ts +++ src/totals.ts @@ -8,6 +8,6 @@ export function invoiceTotal(lines: Line[]): number { - return lines.reduce((sum, l) => sum + round(l.qty * l.price), 0); + const raw = lines.reduce((sum, l) => sum + l.qty * l.price, 0); + return round(raw); }
complete · 29 lines❯ wisdom glance --commit a4c91e2commit a4c91e2b7f30 · fix: round invoice totals once · committed 2026-11-11 09:40Z · version 412parent 7d2e9b1c04aa · 3 files · 3 pieces: 2 from recorded steps, 1 not recordedrecord kept when the commit was made, 2026-11-11 09:40Zthe commit's own diff: git show a4c91e2b7f30
README.md · modify · +1 −0 · not recordedsrc/totals.ts · modify · +2 −1 @@ -9,1 +9,2 @@ t2/c1, t2/c4 in session 3f9c2a71test/totals.test.ts · create · +14 −0 @@ -0,0 +1,14 @@ t2/c2 in session 3f9c2a71
sessions 3f9c2a71-8d4e-4b1a-9c55-2e7f0b6d1a90 claude-code t2/c1, t2/c2, t2/c4 · window t1–t3 window: from the start of these sessions (no earlier commit of yours on this branch), up to this commit
To read a step, open its position in its session, such as {"capture":"3f9c2a71","open":"t2/c1"}.
guide · plain, built from the record now, no model · derived, not evidence · not stored; a model guide on request: wisdom guide a4c91e2b7f30 ## Summary fix: round invoice totals once. Written by Wisdom from the commit's record, without a model: which recorded step made each piece and what was asked in that turn. It does not say why beyond those requests.
## Items - README.md (modify) · not recorded No recording explains this change. - src/totals.ts @@ -9,1 +9,2 @@ · t2/c1, t2/c4 in session 3f9c2a71 Made by [t2/c1 3f9c2a71] (claude-code). Asked in t2: "fix it and add a test". Made by [t2/c4 3f9c2a71] (claude-code). - test/totals.test.ts @@ -0,0 +1,14 @@ · t2/c2 in session 3f9c2a71 Made by [t2/c2 3f9c2a71] (claude-code). Asked in t2: "fix it and add a test".
complete · 28 linesEach part of the commit points to the step that wrote it. New in 0.6.0: see Read a commit.
What you get
Section titled “What you get”- Prompts, replies, tool calls and file diffs, recorded as they happened. Nothing is summarized, and gaps in the recording are marked where they occur.
- One way to read Claude Code, Codex and Pi sessions: for you in the terminal or the dashboard, for your agents through a skill.
- From any commit back to the steps that made it, with
wisdom glance --commit(new in 0.6.0). - Hooks that never block your agent. If the background service is down, events wait on disk.
- Everything stays in the project’s
.wisdom/folder until you choose to share it.
Start with the quick start, or read how it works.