LocalLore lets Claude Code search your earlier coding sessions. It runs locally and does not send your conversations to a hosted search or embedding service.
- Claude Code with plugin support
- Docker with Docker Compose v2
- existing Claude Code sessions, normally in
~/.claude/projects
Run these commands inside Claude Code:
/plugin marketplace add elarsaks/local-lore
/plugin install locallore@locallore
/reload-plugins
/locallore:setup
The first setup builds the container image, downloads the pinned embedding model, starts LocalLore, indexes your existing sessions, and checks that the service is healthy. It can take 30 minutes or longer depending on your network, hardware, Docker build cache, and amount of session history. Keep Docker running and allow the setup command to finish. The first setup requires internet access; search and embedding inference are local afterward.
Ask Claude to remember earlier work:
/locallore:remember Why did we choose SQLite for this project?
You can also ask naturally:
Search LocalLore for the session where we decided how to handle database migrations.
Add details when you know them, such as a project, date range, or file:
Search LocalLore for discussions about ranking in the local-lore project
after 2026-01-01 involving src/locallore/search.py.
See Search session history for all available filters and context controls.
From a repository checkout:
./scripts/status.sh
./scripts/logs.sh
./scripts/doctor.shIf the service has stopped or a marketplace update was installed, run
/locallore:setup again. For troubleshooting steps, see the
troubleshooting guide.
Run the installer for both initial setup and updates:
./scripts/install.shTo use a different Claude session directory:
CLAUDE_PROJECTS_DIR=/path/to/projects ./scripts/install.shLoad the checkout as a development plugin with:
claude --plugin-dir ../scripts/uninstall.shThe script asks before deleting the LocalLore container, derived SQLite index, and runtime configuration. It never deletes Claude Code session files.
The LocalLore documentation contains the complete usage guides, troubleshooting help, architecture, API reference, and explanations of RAG, embeddings, keyword and vector search, indexing, and MCP.
To preview it locally:
uv sync --locked --group docs
uv run --group docs mkdocs serveThen open http://127.0.0.1:8000/.
This repository is a finished, pinned snapshot and is not actively maintained. Review its locked dependencies and security assumptions before adopting it.
LocalLore is licensed under the MIT License.