Claude Code

Each session is a Sovara trace and each prompt a turn. Tool calls are tool steps, Claude’s reply is a model step, and matching lessons are added to the prompt as extra context.

Install the hook program with either runtime:

uv tool install sovara-claude-code     # Python 3.10+
pip install sovara-claude-code         # or pip
npm install -g @sovara/claude-code     # or Node.js 24.22.1+

In Claude Code, add the marketplace and install the plugin:

/plugin marketplace add SovaraLabs/sovara-claude-code
/plugin install sovara-recording@sovara-claude-code

Restart Claude Code to activate the hooks.

The project is the folder you start Claude Code in; set SOVARA_PROJECT to choose another.

Hooks never block Claude Code. If Sovara is unavailable, the session runs unrecorded.
Lessons are recorded as retrieved, not applied: Claude Code doesn’t expose the exact model input, so Sovara can’t confirm what reached the model.

Get started

Agent frameworks

Coding agents