Skip to content

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.

  • Node.js 24 or newer. Wisdom uses the SQLite built into Node, so there’s no database to install. On an older Node, every wisdom command stops with Wisdom needs Node.js 24 or newer. This is v22.x. Check yours with node --version.
  • Claude Code, Codex (0.164.0 or newer) or Pi.
Terminal
npm install -g @oqura/wisdom
wisdom --version

The same commands work on macOS, Linux and Windows. If Windows PowerShell blocks scripts, use npm.cmd and wisdom.cmd in their place.

Terminal
wisdom doctor

Run 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.

Terminal
wisdom daemon stop # in each project
npm install -g @oqura/wisdom@latest
wisdom doctor

Your recorded sessions are kept across updates.

  1. In each connected project, remove Wisdom’s hooks and stop the service:

    Terminal
    wisdom disconnect
    wisdom daemon stop

    If you turned on commit guides or team mode, also remove Wisdom’s git hooks: wisdom guide off or wisdom team hooks off. disconnect leaves them in place.

  2. 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.