Agents & MCP
deja runs an MCP server (deja mcp, stdio) that exposes your indexed history to any MCP-capable agent. deja install wires it into the agents it detects.
Tools
| Tool | What it does |
|---|---|
recall | Search past sessions across every agent and return dense matches under ~4 KB. Fires on phrases like "didn't we fix this before". |
recall_context | Return a full markdown digest of the single best-matching session — the problem, decision and outcome. |
blame | Given a file path, the prior sessions that discussed it, most specific first. git blame for the conversations behind the code. |
remember | Store a durable decision so a future session can recall it. Redacted and indexed like any other source. |
Auto-recall
deja install --auto adds a SessionStart hook (Claude Code, Codex, an opencode plugin). Relevant project memory is injected before you ask — read-only, capped at 2 KB, framed as untrusted historical data so it never acts as an instruction. It also fires right after a context compaction, re-anchoring the model in what it just lost.
Windows
cmd /c deja mcp. deja install writes that form automatically.Seeing it work
Memory that lands silently builds no habit, so the hooks talk — once, when it matters. The session-start receipt names how many sessions were recalled and the day's tally; a per-prompt match on already-solved work announces deja-vu: you have been here — "<that session>" (3w ago); and deja log --last replays the exact digest an agent received.