# Deja Vu

> Deja Vu is a free MCP server for developer tools. Local search and handoff across the saved sessions of 46 coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://vshulcz.github.io/deja-vu/
- **Repository:** https://github.com/vshulcz/deja-vu
- **MCP Registry name:** io.github.vshulcz/deja-vu
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-14

## About

Coding agents already write their sessions to disk, and deja-vu indexes those stores in place so that a fix made in Codex can be recalled in Claude Code. Because it reads existing transcripts, it starts with months of history from before you installed it; the site pitches this against memory tools that record forward only.

Beyond MCP recall it has a terminal interface and commands. deja handoff continues the active session's goal and open work in another agent, deja restore recovers code an agent overwrote before a commit, deja blame traces which session wrote a line, and deja audit checks retention risk and purged chats. A Deleted view keeps sessions an agent purged from disk.

It is a single Go binary with no LLM calls and no accounts. Credentials such as keys, tokens and private key blocks are stripped when indexing, and nothing leaves the machine unless you ask. The README reports 97.2% R@5 on LongMemEval-S and a 0.7 ms lookup, with drivers and scoring rules in the repository.

## Features

- **Existing history indexed:** Reads agent session stores in place with no capture step.
- **Cross-agent handoff:** Continues a session's goal and decisions in another agent.
- **Code recovery:** Restores code an agent overwrote before it was committed.
- **Credential stripping:** Removes keys and tokens from the index.
- **Terminal and HTML views:** Searches in the terminal or exports a local HTML file.

## Good for

- Recall how a bug was fixed in a different agent
- Hand a half-finished task to another coding agent
- Recover a file overwritten before commit
- Audit which agent session changed a line
- Survive context compaction with exact commands and decisions

## Install

### Claude Code (Terminal)

```sh
claude mcp add deja-vu -- npx -y @vshulcz/deja-vu
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "@vshulcz/deja-vu"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "@vshulcz/deja-vu"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "deja-vu": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vshulcz/deja-vu"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "@vshulcz/deja-vu"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "@vshulcz/deja-vu"
      ]
    }
  }
}
```

## Tools

- `deja`: Recalls matching session history, called with mode recall and a query.

## FAQ

### Does it call an LLM?

No. The site says it makes zero LLM calls.

### Is anything uploaded?

No. Indexing and search are local and nothing leaves your machine unless you ask.

### How do I install it?

Run npx @vshulcz/deja-vu install --auto, or use the shell script or Homebrew.

### Which agents are supported?

The README says 46, including Claude Code, Codex, Cursor, Gemini CLI, OpenCode and OpenClaw.

### Is Deja Vu free?

Yes. Deja Vu is free to use.

### How do I add Deja Vu to Claude Code?

Run this command in your terminal: claude mcp add deja-vu -- npx -y @vshulcz/deja-vu

### What are the best alternatives to Deja Vu?

The closest alternatives to Deja Vu are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/deja-vu
