convovault

Vault your Claude conversations. Never re-explain yourself again.

Persistent cross-surface memory for Claude. Capture session context across Code, Cowork, and Chat. Organize by project, skill, and persona.

One command to install:

bash install.sh

This creates a virtual environment, installs dependencies, and verifies everything works. No system Python changes, no manual pip commands.

Start a session with the plugin loaded:

claude --plugin-dir /path/to/convovault

Or load it inside an existing session:

/plugin add /path/to/convovault

Replace /path/to/convovault with wherever you saved the source folder (e.g., ~/projects/side_hustle/ron_skills/convovault).

After making code changes, use /reload-plugins to refresh without restarting.

Once loaded, Claude has access to all 11 ConvoVault MCP tools automatically. Ask Claude to "save this session" or "recall what we discussed about X" and it will use the tools on its own.

1. Click the + button next to the prompt box
2. Select Plugins
3. Select Add plugin
4. Browse to the convovault source folder

Important: Shared Database Access

Cowork runs in a sandboxed VM and can't see your Mac's filesystem by default. To read sessions saved by Claude Code, ask Claude in Cowork:

> "Mount my ~/.convovault folder"

Once mounted, Cowork reads and writes to the same database as Claude Code. Sessions saved in Code appear instantly in Cowork.

Chat doesn't support plugins, so ConvoVault provides a one-command bridge. Run this in your terminal:

bash export-to-chat.sh

This exports your last session and copies it to your clipboard (macOS). Switch to Chat and paste (Cmd+V). Chat instantly has the context from your Code or Cowork session.

To search for a specific session:

bash export-to-chat.sh "tax prep"