Skip to content
MCP server

Deja Vu

Local search and handoff across the saved sessions of 46 coding agents

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.24.2
Listing updated
3 days ago

About Deja Vu

Deja Vu is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "@vshulcz/deja-vu"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "@vshulcz/deja-vu"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Free

No accounts; local binary

Prices change. Check vshulcz.github.io before you buy.

Deja Vu 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 to Deja Vu

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools