Who it is forA developer who keeps re-explaining past decisions to Claude Code because each session starts from zero.
The problemOld Claude Code sessions are hard to search, and the README warns they expire in 30 days without auto-save hooks wired.
The outcomeA local palace of verbatim sessions and project files you can search in plain language, plus a wake-up command that loads context for a new session.
What you need first
- Python 3.10 or newer
- uv or pipx recommended for the CLI (plain pip only inside a virtualenv)
- A vector-store backend (ChromaDB by default, no configuration)
- About 300 MB of disk for the embedding model
- Docker only if you use the container image
Steps
- Run
uv tool install mempalaceto put the MemPalace CLI in an isolated environment on your PATH (orpipx install mempalace) - Run
mempalace init ~/projects/myappwith the path to your own project - Run
mempalace mine ~/projects/myappto mine the project files into the palace - Run
mempalace mine ~/.claude/projects/ --mode convosto mine your Claude Code sessions (scope with --wing per project) - Run
mempalace search "why did we switch to GraphQL"with your own question to find the original conversation - Run
mempalace wake-upto load context for a new session - Run
mempalace auditto score how well organized the palace is (read-only)
Prompt for your agent
Install MemPalace/mempalace with `uv tool install mempalace`, run `mempalace init` on this project, then mine my Claude Code sessions with `mempalace mine ~/.claude/projects/ --mode convos`. Before answering any question about past decisions in this repo, run `mempalace search` with the question and quote the matching original text. Do not delete or move any transcript files.
Caveat. The palace holds your full transcripts verbatim, so keep it on a disk you trust. The README points to its Claude Code retention setup checklist for wiring the auto-save hooks and backing up existing JSONL transcripts.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for MemPalace/mempalace and "Give Claude Code searchable memory of your past sessions"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer