LoreConvo v0.7.1
Your memory follows your identity, not your tool — with your consent.
LoreConvo is the only AI memory that carries your context across Claude Code, Codex, Cursor, and Hermes Agent. One install, one memory, everywhere you code.
Available on the Anthropic Marketplace. Install directly from Claude, or via PyPI: uvx loreconvo
Why LoreConvo?
Your memory follows you across tools
Every coding environment walls off context by machine and workspace. Claude Code, Codex, Cursor, Hermes Agent — each keeps its own memory. When you switch between them, you start over.
LoreConvo treats your identity as portable. All your tools can access the same memory from a single install. Your context follows you, not your tool.
You control what gets saved
Competing tools auto-write to memory without asking. LoreConvo puts you in control: you decide what's worth keeping, and you can delete any memory at any time.
Every memory shows you exactly where it came from — which surface captured it, when, what project context it belongs to, and which skill generated it. No mystery. Full provenance.
Your memory stays on your machine
LoreConvo stores everything in a SQLite database on your own machine. No data leaves your computer. No cloud accounts. No vendor with access to your session history.
Your sessions live in ~/.loreconvo/sessions.db -- a file you own, can back up, and can delete whenever you want.
Structured memory, not raw transcripts
LoreConvo captures two types of memory for each session:
- Episodic memory: what happened -- summaries, artifacts created, open questions left behind
- Semantic memory: what was decided -- stable conclusions about the project that persist across sessions
Together these give Claude a structured, searchable record of your project's history, not just a pile of chat transcripts.
Recall Benchmark
LoreConvo's FTS5 search is benchmarked against a 60-session synthetic corpus (6 topic areas, 36 labeled queries).
| Variant | Recall@5 | MRR |
|---|
| FTS5 + compound token expansion (default) | 88.9% | 0.875 |
| FTS5 baseline (no expansion) | 72.2% | 0.708 |
Compound token expansion (camelCase / snake_case query preprocessing) lifts Recall@5 by +35.7 pp on queries using technical identifiers like autoSave, pipeline_tracker, and get_context_for.
Full benchmark report |
Reproduce
Quick Start
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.
Using LoreConvo
Claude Code (Terminal)
Start a session with the plugin loaded:
claude --plugin-dir /path/to/loreconvo
Or load it inside an existing session:
/plugin add /path/to/loreconvo
Replace /path/to/loreconvo with wherever you saved the source folder.
After making code changes, use /reload-plugins to refresh without restarting.
Once loaded, Claude has access to all 28 LoreConvo 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.
Cowork (Desktop App)
- Click the + button next to the prompt box
- Select Plugins
- Select Add plugin
- Browse to the
loreconvo 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 ~/.loreconvo folder"
Once mounted, Cowork reads and writes to the same database as Claude Code. Sessions saved in Code appear instantly in Cowork.
Claude Chat (Web)
Chat doesn't support plugins, so LoreConvo 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"
How It Works Across Surfaces
The core value of LoreConvo is that context persists across Claude surfaces automatically. Here is the full chain:
Claude Code (terminal)
|-- SessionEnd hook --> auto_save.py --> ~/.loreconvo/sessions.db
|-- SessionStart hook <-- auto_load.py <-- ~/.loreconvo/sessions.db
^
Cowork (desktop app) <--MCP tools-------------|
save_session / get_recent_sessions / search_sessions
Claude Chat (web)
|-- export-to-chat.sh --> clipboard --> paste into Chat
Claude Code is the primary surface. The hooks run automatically:
