Skip to content

Reference

CLI

Every command and option of the wisdom CLI.

Every command finds .wisdom/ from the current folder upward, the way git finds .git. On Windows PowerShell with scripts blocked, type wisdom.cmd.

<session> is a session ID, its first 8 or more characters, or latest. <position> is t3 (a turn), t3/c2 (a tool call), a1 (a subagent), a1/c2, or outside.

Command What it does
wisdom connect Record plain claude, codex and pi started here, with your own login. Run again to repair.
wisdom disconnect Take out exactly what connect added. Recordings are kept.
wisdom init Set up .wisdom/ and a home for each agent, for wisdom track. Run again to repair.
wisdom doctor Check that everything works, and print the fix for each problem.
Command What it does
wisdom track claude|codex|pi Start an agent with its home in this project, recording.
wisdom resume <session-id> Continue a recorded session, still recording. Full ID only.
wisdom handoff <claude|codex|pi|session-id> Continue in a new or existing session that reads another session first.
Command What it does
wisdom glance List recorded sessions, newest first.
wisdom glance <session> One session’s shape and every turn.
wisdom open <position> --capture <session> One turn, tool call or subagent, whole.
wisdom glance --commit <commit> Which recorded steps made each piece of a commit (a hash, a branch or HEAD).
wisdom dashboard Print the address of the live dashboard.

New in 0.6.0. See Read a commit.

Command What it does
wisdom guide <commit> Have a model write that commit’s guide now, and keep it in the commit’s record.
wisdom guide on|off Whether a model writes a guide after each of your commits. Off by default; on by default in team mode.

New in 0.6.0. See Share with your team.

Command What it does
wisdom team init Write wisdom-team.json. Commit it to turn team mode on.
wisdom team hooks on|off Install or remove Wisdom’s three git hooks. connect and init install them in a team-mode repository.
wisdom team push Send your sessions and commit records now, without a git push.
wisdom team fetch Bring teammates’ sessions here, read-only, and apply the deletion list.
wisdom team delete <session> Remove a pushed session for everyone. Your own recording is kept.
wisdom team prune Remove pushed sessions older than retentionDays.
wisdom check --range <base>..<head> For CI: check each commit’s guide, and that its sessions are on the remote. Exits with 1 when a commit needs attention.
Command What it does
wisdom share <session>... Write one file to send a teammate, after a secret check.
wisdom import <file> Read a teammate’s file here, read-only.
wisdom export <session> Write a session as Markdown, after a secret check.
wisdom clone <session> Carry a session on as a new one, in the same agent.
Command What it does
wisdom daemon start|stop|status Control the background service.
wisdom daemon run Run it in the foreground.
wisdom mcp Serve the optional read-only MCP tool, ledger.
wisdom --version Print the version.
Option Used with What it does
--cwd DIR any Use the project at DIR.
--data DIR any Use the data folder DIR directly. Also WISDOM_DATA_DIR.
--from N glance, open Continue a long answer from line N.
--at VERSION glance, open Read at a fixed version.
--plain glance, open In a terminal, print the exact text agents read.
--commit <commit> glance Read a git commit instead of a session.
--range <base>..<head> check The commits to check, as git names a range.
--remote NAME team, check Use this remote instead of the one in wisdom-team.json.
--from <session-id> handoff The session to read. Default: the newest from another agent.
--port N daemon Use exactly this port.
--no-dashboard daemon Don’t start the dashboard.
--claude-bin FILE, --codex-bin FILE, --pi-entry FILE track Use another installation of the agent.
--setup-hooks track codex Review Wisdom’s hooks in /hooks, first time only.
--trust-all-hooks track codex Skip the review for every hook in that run. Only in repositories you trust.
-- ARGUMENTS track, handoff track: pass the rest to the agent. handoff: add it to the first prompt.
--out FILE share, export Where to save. Default .wisdom/shared-out/. export --out - prints it.
--redact, --keep-secrets share, export Redact or keep what the secret check finds, without asking.