claude-memory — Claude Code plugin: searchable conversation memory
claude-memory keeps past Claude sessions in a local SQLite file, then hands the most recent one back as context when a new session begins.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-memory@ClaudestWhat claude-memory does
A stop hook reads the session transcript in JSONL, splits it into messages, marks branches left by rewinds, and writes it all to ~/.claude-memory/conversations.db. On the next start a second hook pulls the latest substantial session for the same project and injects it. That is what makes plan-now, build-later survive a context reset.
Two skills ship with it. recall-conversations does keyword lookup through FTS5 with BM25 ranking, or browses sessions in time order, and the agent writes the queries itself from your wording. extract-learnings rereads old chats, picks out insights worth keeping, and suggests which memory layer each one belongs to (CLAUDE.md, MEMORY.md, topic files). Nothing is written until you approve.
Python 3.7+ is the only prerequisite, standard library included. Semantic search is opt-in: EmbeddingGemma 2 runs inside a local Ollama, the model download is about 360 MB, and the switch is python3 hooks/semantic_setup.py --enable. With Ollama down, search falls back to keywords and warns you. semantic_min_score sits at 0.70 by default and drops meaning-based hits below that similarity.
What it helps with
- resume a project from the point the last session stopped
- find the chat where the schema migration came up
- see which files were touched last time
- move lessons from old sessions into
CLAUDE.md - search past conversations by meaning rather than exact wording
Example prompts for the agent
- What did we settle on for the database migration last session?
- Pick up where we left off yesterday.
- Dig through our past chats and tell me why we dropped that approach.
How to install claude-memory
Plugin marketplace
/plugin marketplace add gupsammy/Claudest/plugin install claude-memory@ClaudestStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about claude-memory
How do I install claude-memory in Claude Code?
Run /plugin marketplace add gupsammy/Claudest, then /plugin install claude-memory@Claudest. Both steps, in that order.
What does claude-memory do?
It stores your conversations in a local database with full-text search, injects the previous session's context at startup, and gives the agent skills for recalling old work.
What is needed for semantic search?
A local Ollama running EmbeddingGemma 2, roughly 360 MB. Turn it on with python3 hooks/semantic_setup.py --enable; ollama_url and embedding_model override the defaults.