deja-vu

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

Search it yourself

deja with no arguments in a terminal opens a search over every agent's history. It starts on the sessions behind your uncommitted change, then the recent ones in this project, and the list narrows as you type.

• ↑↓ picks a session, ↵ opens it at the match, n and N step through the matches, esc goes back. Inside a session, / finds a word and ] [ jump between the turns you asked.
• The box takes filters: an agent with a colon (codex:), today, yesterday, week, month, and in:<project>.
• r resumes the session in the agent that wrote it. o continues it in any other agent, which starts with what the session asked, decided and left open.
• tab switches between this project, all projects and Deleted, the sessions their agent deleted that deja still holds; R puts one back.
• ? lists every key, ^k has the rest (copy the session id or project path, forget a session), q quits from the list; esc steps back and quits from an empty search box.

With DEJA_TUI=0 it prints the text summary instead, which is also deja brief. Piped, it prints what is indexed and which command to run next.

Highlights

• Starts full. Months of history from before you installed it are searchable on day one: deja "connection pool exhausted" over gigabytes.
• One memory, every agent. A fix found in Codex comes back in Claude Code, Cursor or opencode; all forty-one agents read the same index.
• Nobody has to ask. Recall arrives at session start, before a file is edited or a command runs, and after a command fails.
• Survives compaction. Over 43 measured compactions the summary kept 77% of the decisions and 0.2% of the commands; deja hands back the rest (how).
• Indexes the work, not just the talk. The files each turn opened, the commands with their exit status, the exact spans an edit replaced.
• Knows what held. deja promote <id> --state rejected marks a reverted decision, and every later hit says it was tried and why it was dropped; --state accepted takes the mark back.
• Says when the ground moved. A hit reports 4 files this session touched have changed since, and stays quiet when it cannot tell.
• Local and private. No model, no embeddings, no server. Keys and tokens are stripped as the index is built (privacy).
• Moves with you. deja sync ssh laptop between machines, no cloud in between; deja handoff --to codex to continue in another agent.
• One Go binary. macOS, Linux and Windows, through Homebrew, Scoop, winget, npm or go install.

Your own work, wrapped

deja stats --card draws it in the terminal; give it a filename and it writes an SVG for a profile README. To post it anywhere else, turn it into a PNG — that page converts it in your own browser.

The full feature reference lives in the docs.

Install

The two commands at the top are the whole install on macOS and Linux:

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

The script puts the binary in ~/.local/bin. If that directory is not on your PATH yet, the second command is not found in the same shell: run the next: line the script prints, which has the full path, or open a new shell once the PATH line is added.

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. To look for yourself, run deja.

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, Cursor, Qwen and OpenClaw can take the same plugin bundle from their own marketplaces instead (Codex has a bundle of its own, in the table under Harnesses with a package of their own). Copilot CLI installs it too but takes only the skill, so use deja install copilot-auto there:

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, from the main bucket every Scoop install already has, or winget, which ships with Windows:

scoop install deja-vu
winget install vshulcz.deja-vu

Or take deja-vu_<version>_windows_amd64.zip from the latest release and put deja.exe on your PATH, e.g. in %USERPROFILE%\.local\bin.

The binary alone is a complete install for searching: index, search, show, ctx, blame, --json and redaction need nothing else. deja install is what wires MCP into your agents and turns on ses