deja-vu is a local-first agent-memory tool maintained by vshulcz (Vladislav Shulcz) under the MIT license; it is not an official project of any agent vendor. Its distinguishing claim is where memory comes from: it indexes the session histories already on disk, so it is useful immediately after install and can surface work done months before, rather than starting empty and recording forward. The README reports 85.3% hit@1 on LongMemEval-S, 69.6% on LoCoMo, and about 0.4 ms median in-process lookup over a 5.2 GB store of 1,551 sessions. On the MCP side it exposes one tool, deja, with a mode switching between six behaviors, and it also hooks into PreToolUse/PostToolUse for recall at the point of action. It suits developers running multiple coding agents who value local-only, LLM-free retrieval, and is a poor fit for those who need hosted shared memory or cannot accept the limits of pattern-based redaction.
deja-vu is a local-first memory layer that indexes the session histories coding agents on your machine have already written to disk (Claude Code, Codex, Cursor, Copilot CLI, OpenClaw and roughly twenty others in total) and hands the relevant memory back to whichever agent asks. Nothing leaves the machine by default: indexing and search are local, and credentials are redacted at index time. Per the project's README, lexical retrieval needs no LLM and no embedding key; semantic recall is optional and requires pointing deja embed at a local Ollama/LM Studio instance or an OpenAI-compatible endpoint. It serves MCP over stdio and exposes a single tool named deja whose mode argument selects behavior (recall, context, blame, fix, how, remember); six older tool names (recall, recall_context, blame, fix, how, remember) still answer for existing wiring. Install paths include the install script, Homebrew, go install, Scoop, and npx @vshulcz/deja-vu, and deja install wires MCP recall into the agents it detects.
1) Install: on macOS/Linux run curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh; alternatives are brew install deja-vu or go install github.com/vshulcz/deja-vu/cmd/deja@latest; on Windows use scoop install deja-vu (the install script exits with 'unsupported OS' there). 2) Run deja install --auto to wire MCP into every agent it detects, enable session-start recall where supported, and build the first index; add --all to skip session-start recall, or --no-guidance to avoid writing per-harness guidance files. 3) To configure MCP by hand, use the stdio command npx @vshulcz/deja-vu mcp, or invoke deja mcp directly. 4) Verify with deja doctor [--deep].
{"mcpServers":{"deja-vu":{"command":"npx","args":["@vshulcz/deja-vu","mcp"]}}}