Deja-vu MCP Server: Memory for Your Coding Agents
Lets Claude Code, Cursor, Codex and other coding agents recall what you solved and decided in earlier sessions.
This is a community tool, not made by any of the agents it works with. It builds an index of the chat history your coding agents already keep on your disk, and gives the relevant parts back through one MCP tool and optional hooks. It runs on your computer, makes no LLM calls and needs no cloud account.
The install script also wires itself into every agent it finds, so read the safety notes before you run it.
Good for
- Developers who use several coding agents and want each to know what the others already did
- People who keep re-explaining the same project rules, banned tools and past fixes to the agent
- Anyone who wants agent memory that stays on their own computer
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install deja-vu MCP
Claude Code
- 1
Copy this prompt.
Add the deja-vu MCP server to Claude Code. Run this command: curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh deja install --auto Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires macOS or Linux, curl.
Read-only mode: There is no read-only switch. Only the remember mode writes a note.
Install the deja binary first with the install script. It puts deja in ~/.local/bin, so a desktop app may need that folder on its PATH. The config shown is our adaptation: the README names the deja mcp command, and the repo's Codex plugin file uses it the same way. On Windows, install with Scoop or winget and use cmd /c deja mcp if the app cannot start deja directly.
From the project README. Source.
Tools
Searches what your past coding sessions already solved and decided
One tool with eight modes. It can recall past sessions by file, error or flag, read one session in full, show why a file changed, find the fix that followed an error, look up the command you really use, list commands and files from this project, store a decision for later, and hand off another session's work.
Try: “Have we dealt with jwt refresh rotation before?”
Write ·
deja
Read from the source code
Permissions
medium risk · 5 things to watch
Medium risk
It reads the full history of your coding agents, edits their settings when you run the auto install, and can store notes that later sessions follow. Install it for one agent first and check what it wrote.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
The installer edits every coding agent it finds
deja install --auto writes into every coding agent it finds. For Claude Code that is a deja entry in ~/.claude.json, seven hooks in ~/.claude/settings.json (SessionStart, PreCompact, UserPromptSubmit, PreToolUse, PostToolUse, PostToolUseFailure, SessionEnd) and a /deja command file in ~/.claude/commands. The hooks run deja on each prompt and before edits and shell commands. Install one agent at a time if you want control. github.com
It indexes everything your agents did on this machine
The index holds past chats, commands, file paths and edits. Credentials are masked in the index, but the original transcripts still hold them. The deja secrets command lists the sessions that do. github.com
It tells your agent to call it before edits
The server's built-in instructions ask the agent to recall before it starts debugging and before its first edit in a task. That is the point, but it adds calls you did not ask for. github.com
The remember mode stores notes for later sessions
A decision saved this way is returned to future sessions as guidance. Review stored notes if a wrong one gets in. github.com
Optional embeddings send your search text out
If you turn on semantic recall, each search sends the query to the embedding endpoint you configured. github.com
Security advisories
No published security advisories for the MCP server as of Nov 1, 2026.
1 other advisory is about the wider deja-vu project, not this MCP server. See them on GitHub
Technical details
| Talks to | None for search and recall. Update checks, sync over SSH and optional embedding calls to an endpoint you set use the network. |
|---|---|
| Sign-in and keys | No sign-in. The index lives in ~/.cache/deja by default. |
Questions
Is deja-vu official?
No. It is a community project by vshulcz, not made by Anthropic, OpenAI, Cursor or any other agent maker. It is MIT licensed.
Does my chat history leave my computer?
Not for indexing and search. The README says the network is used only for updates, SSH sync, the version check and an optional embedding endpoint you set. The index lives on your disk.
Which agents does it work with?
The README lists more than 40 coding agents, including Claude Code, Codex, Cursor, Gemini CLI, opencode, Copilot, Cline and Zed. Some get MCP only, some also get hooks and a skill.
How many tools does it have?
One, called deja, with a mode that picks the job. The six older tool names still answer for clients that have them saved. That keeps the cost per turn low.
Do I have to run the install script?
No. The binary alone gives you search from the terminal. You can add just the MCP entry to one agent with the config in the install box, and use the install script only if you want hooks and automatic recall.
Does it work on Windows?
Yes, with Scoop, winget or a release zip, because the install script is a shell script. For some agents the MCP command needs a cmd /c deja mcp wrapper, which the agent setup guide covers.
Can it hide passwords and keys?
Partly. Keys, tokens, JWTs, PEM blocks and passwords in URLs are replaced with a redacted marker in the index. The original transcripts still contain them, and the security notes say redaction cannot catch everything.
Can I make it read-only?
There is no switch. The remember mode is the one that stores a note. You can also keep projects out of the index with the exclude file.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
@vshulcz/deja-vu- Registry
- npm
- Transport
- stdio
- Auth
- None
- Version
- 0.23.3
- License
- MIT
- Last commit
- Oct 31, 2026
- Open issues
- 25
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- deja-vu README · github.com
- deja MCP tool definition at v0.23.3 · github.com
- deja installer source (Claude Code wiring) · github.com