deja-vu

<p align="center"><b>Memory for coding agents, starting with the history you already have.</b></p> <p align="center">Your agent is about to re-debug something you fixed in March. deja indexes the sessions Claude Code, Codex, Cursor and every other agent on this machine already wrote to disk, and hands the right one back when it is needed.</p> <p align="center"><img src="assets/demo.gif" width="720" alt="The same question put to the same agent twice: without memory it has no record of it, with deja it answers with the decision from eight months earlier"></p> <p align="center">_{<em>Nobody searched anything — the agent called deja itself. Every line is quoted from two real sessions.</em>}</p> <p align="center"><b>Every memory tool starts empty and records forward. deja starts full.</b></p> <p align="center">And nobody has to ask for it: recall arrives at session start, on every prompt, before a file is edited or a command runs, and after one fails. Keys and tokens are stripped as the index is built, so what reaches the model is safe to send.</p>

<b>85.3% hit@1</b> on LongMemEval-S · <b>69.6%</b> on LoCoMo · <b>sub-millisecond</b> lookups over 5 GB of history<br> _{Both harnesses ship in this repo and run on the public datasets in minutes · <a href="https://vshulcz.github.io/deja-vu/guide/benchmarks.html">check the numbers yourself</a>}

<p align="center">English | <a href="README.zh.md">中文</a></p> <p align="center"><a href="https://vshulcz.github.io/deja-vu/">Docs</a> &middot; <a href="https://vshulcz.github.io/deja-vu/guide/benchmarks.html">Benchmarks</a> &middot; <a href="https://vshulcz.github.io/deja-vu/guide/compare.html">How it compares</a></p>

Install

curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto

<p align="center"><img src="assets/banner.png" width="700" alt="What deja prints after the first index: the mark, the agents it found, and a query taken from your own history"></p>

Ten seconds to install, about ten to index, and it is useful. The second command wires MCP recall into every agent it finds, turns on session-start recall where the agent supports it, and builds the first index so the next session does not pay for it.

Start a new agent session and ask it something you worked on months ago:

have we dealt with jwt refresh rotation before? check your memory

It does not have to be asked, either — with auto-recall the agent already knows what you solved in that project when the session opens.

Other ways to install, and what to do if you want less than all of it

brew install deja-vu, go install github.com/vshulcz/deja-vu/cmd/deja@latest, or npx @vshulcz/deja-vu "query" to try it without installing anything. Desktop apps that take MCP servers as bundles can open the .mcpb from the latest release; it carries the binary.

Claude Code, Codex, Cursor, Qwen, OpenClaw and Copilot can take the same plugin bundle from their own marketplaces instead:

claude plugin marketplace add vshulcz/deja-vu && claude plugin install deja-vu@deja-vu

On Windows the install script exits with unsupported OS — it is a shell script. Use Scoop instead, from the main bucket every Scoop install already has:

scoop install deja-vu

…