git:20260916.3563a60 to git:20260918.b6d81cc

2 added, 2 removed. Audit B to B.

# deja-vu

> Local memory for coding agents, built from the session transcripts they already write to disk. deja indexes what Claude Code, Codex, Cursor, opencode, Gemini CLI, Zed and twenty-seven more agents wrote on this machine — including the months before it was installed — and answers from them over MCP or the command line. BM25 over the transcripts: no model, no embeddings, nothing leaves the machine.

Two things distinguish it from memory tools that record forward: it starts full, because the history is already on disk, and recall arrives without being asked — at session start, on each prompt, before an edit or a command, after a command fails, and on the way back from a compaction, where deja keeps the task, files and commands the summary drops. Credentials are stripped as the index is built.

Install is one command (`curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh`, or `brew install deja-vu`), followed by `deja install --auto` to wire the agents found on the machine.

## Start here

- [Getting started](https://vshulcz.github.io/deja-vu/guide/getting-started.html): install, wire an agent, and the first query

- [Why agents forget](https://vshulcz.github.io/deja-vu/guide/forgetting.html): what ends with a session and what survives on disk

- [Does my agent remember previous conversations](https://vshulcz.github.io/deja-vu/guide/does-my-agent-remember.html): what Claude Code, Codex and Cursor keep between sessions, and what they do not

- - [Where history lives](https://vshulcz.github.io/deja-vu/guide/where-sessions-are-stored.html): the conversation history file each of the thirty-two agents writes, and its format

+ - [Where history lives](https://vshulcz.github.io/deja-vu/guide/where-sessions-are-stored.html): the conversation history file each of the thirty-three agents writes, and its format

- [Session files on disk](https://vshulcz.github.io/deja-vu/guide/session-files-on-disk.html): how to delete Claude Code sessions, how large ~/.claude/projects gets, what is inside a session file, and what deleting one costs

- [CLI reference](https://vshulcz.github.io/deja-vu/guide/commands.html): every command and flag

- [Agents & MCP](https://vshulcz.github.io/deja-vu/guide/agents.html): the deja MCP tool and its modes, and what each harness supports

## Problems it answers

- [The agent lost the context you had](https://vshulcz.github.io/deja-vu/guide/lost-context.html): after a crash, a clear, or a restart

- [The context window is full](https://vshulcz.github.io/deja-vu/guide/context-window-full.html): what compaction keeps (77% of decisions, 0.2% of commands, measured) and what to do instead

- [Resuming a session](https://vshulcz.github.io/deja-vu/guide/resume-a-session.html): find it across every agent, reopen it in the one that owns it

- [The agent repeats a mistake you already fixed](https://vshulcz.github.io/deja-vu/guide/repeated-mistakes.html): the same error again, in a repository that solved it before

- [Finding a session](https://vshulcz.github.io/deja-vu/guide/find-a-session.html): search chat history across every agent at once

- [Switching agents](https://vshulcz.github.io/deja-vu/guide/switching-agents.html): move between Claude Code, Codex and Cursor without re-explaining

- [After compaction](https://vshulcz.github.io/deja-vu/guide/after-compaction.html): recovering the commands a summary dropped, and the packet deja hands back automatically

- [Auditing an agent](https://vshulcz.github.io/deja-vu/guide/auditing-agents.html): review agent changes when the diff cannot say what was tried

- [Exporting a conversation](https://vshulcz.github.io/deja-vu/guide/export-conversations.html): markdown, JSON, or a shareable page

- [Across machines](https://vshulcz.github.io/deja-vu/guide/sync-across-machines.html): sync between machines with no server

- [What memory costs](https://vshulcz.github.io/deja-vu/guide/token-cost.html): the measured token cost of recall

- [Stats card to PNG](https://vshulcz.github.io/deja-vu/card/): turn the card `deja stats --card` writes into a PNG, in the browser

## 中文

- [快速开始](https://vshulcz.github.io/deja-vu/zh/guide/getting-started.html)：安装、接上智能体、第一次查询

- [智能体记得之前的对话吗](https://vshulcz.github.io/deja-vu/zh/guide/does-my-agent-remember.html)：各个工具跨会话留下了什么

- [为什么会忘事](https://vshulcz.github.io/deja-vu/zh/guide/forgetting.html)：会话结束时消失的是什么，磁盘上留下的是什么

## Per-harness setup

- [Claude Code, Codex and the rest](https://vshulcz.github.io/deja-vu/guide/harnesses.html): the full support matrix

- [Claude Code](https://vshulcz.github.io/deja-vu/guide/memory-for-claude-code.html)

- [Codex](https://vshulcz.github.io/deja-vu/guide/memory-for-codex.html)

- [Cursor](https://vshulcz.github.io/deja-vu/guide/memory-for-cursor.html)

- [Copilot CLI](https://vshulcz.github.io/deja-vu/guide/memory-for-copilot.html)

- [opencode](https://vshulcz.github.io/deja-vu/guide/memory-for-opencode.html)

- [DeepSeek Harness](https://vshulcz.github.io/deja-vu/guide/memory-for-dsh.html)

- [Kimi Code](https://vshulcz.github.io/deja-vu/guide/memory-for-kimi.html)

- [Zed](https://vshulcz.github.io/deja-vu/guide/memory-for-zed.html)

- [VS Code Copilot Chat](https://vshulcz.github.io/deja-vu/guide/memory-for-copilot-chat.html)

- [Grok Build](https://vshulcz.github.io/deja-vu/guide/memory-for-grok.html)

- [Gemini CLI](https://vshulcz.github.io/deja-vu/guide/memory-for-gemini.html)

- [Qwen Code](https://vshulcz.github.io/deja-vu/guide/memory-for-qwen.html)

- [Roo Code](https://vshulcz.github.io/deja-vu/guide/memory-for-roo.html)

- [prime-agent (PrimeIntellect)](https://vshulcz.github.io/deja-vu/guide/memory-for-prime.html)

- [Continue](https://vshulcz.github.io/deja-vu/guide/memory-for-continue.html)

- [Crush](https://vshulcz.github.io/deja-vu/guide/memory-for-crush.html)

- [OpenClaw](https://vshulcz.github.io/deja-vu/guide/memory-for-openclaw.html)

- [Goose](https://vshulcz.github.io/deja-vu/guide/memory-for-goose.html)

- [Cline](https://vshulcz.github.io/deja-vu/guide/memory-for-cline.html)

- [pi and omp](https://vshulcz.github.io/deja-vu/guide/memory-for-pi.html)

- [Amp](https://vshulcz.github.io/deja-vu/guide/memory-for-amp.html): plugin API modelled on pi's, plus MCP

- [Hermes](https://vshulcz.github.io/deja-vu/guide/memory-for-hermes.html)

## Evidence

- [Benchmarks](https://vshulcz.github.io/deja-vu/guide/benchmarks.html): 85.3% hit@1 on LongMemEval-S, 69.7% on LoCoMo, both harnesses in the repository

- [How it compares](https://vshulcz.github.io/deja-vu/guide/compare.html): next to Mem0, Letta, memU, Memori, claude-mem and agentmemory

- - [Session format registry](https://vshulcz.github.io/deja-vu/registry/README.html): where each of the thirty-one agents stores its sessions, with fixtures

+ - [Session format registry](https://vshulcz.github.io/deja-vu/registry/README.html): where each of the thirty-three agents stores its sessions, with fixtures

- [Privacy](https://vshulcz.github.io/deja-vu/guide/privacy.html): what is read, what is redacted, what never leaves

## Optional

- [Architecture](https://github.com/vshulcz/deja-vu/blob/main/docs/ARCHITECTURE.md)

- [Security model](https://github.com/vshulcz/deja-vu/blob/main/docs/SECURITY-MODEL.md)

- [Installing deja for an agent](https://github.com/vshulcz/deja-vu/blob/main/llms-install.md): the install page written for an agent doing it on a user's behalf

- [JSON output](https://github.com/vshulcz/deja-vu/blob/main/docs/json-output.md): the shape of every `--json` result

- [Compaction recovery](https://github.com/vshulcz/deja-vu/blob/main/docs/compaction.md): what is captured before a compaction, what is handed back, and the limits