Getting started
Installation
Install Wisdom with npm, check it works, update or remove it.
Wisdom is one npm package. Install it once per machine, then connect each project you want to record.
Requirements
Section titled “Requirements”- Node.js 24 or newer. Wisdom uses the SQLite built into Node, so there’s no database to
install. On an older Node, every
wisdomcommand stops withWisdom needs Node.js 24 or newer. This is v22.x.Check yours withnode --version. - Claude Code, Codex (0.164.0 or newer) or Pi.
Install
Section titled “Install”npm install -g @oqura/wisdomwisdom --versionThe same commands work on macOS, Linux and Windows. If Windows PowerShell blocks scripts,
use npm.cmd and wisdom.cmd in their place.
Check a project
Section titled “Check a project”wisdom doctorRun it inside a project. It checks the background service, each agent’s hooks and version, and any events waiting to be recorded. It changes nothing, and prints the command that fixes each problem it finds.
Update
Section titled “Update”wisdom daemon stop # in each projectnpm install -g @oqura/wisdom@latestwisdom doctorYour recorded sessions are kept across updates.
Uninstall
Section titled “Uninstall”-
In each connected project, remove Wisdom’s hooks and stop the service:
Terminal wisdom disconnectwisdom daemon stopIf you turned on commit guides or team mode, also remove Wisdom’s git hooks:
wisdom guide offorwisdom team hooks off.disconnectleaves them in place. -
Remove the package:
Terminal npm uninstall -g @oqura/wisdom
Your recordings stay in each project’s .wisdom/ folder until you delete it. Wisdom never
changes ~/.claude, ~/.codex or ~/.pi/agent, so your agents work exactly as before.
Next: Quick start.