Skip to content
MCP server

deja-vu — Coding Agent Memory & Session Search

Local search and shared memory across your coding agents' session history

Runs locally
Install

deja-vu — Coding Agent Memory & Session Search is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.25.0
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add claude-codex-cursor-agent-memory-deja-vu -- npx -y https://github.com/vshulcz/deja-vu/releases/download/v0.25.0/deja-vu_0.25.0_registry.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "claude-codex-cursor-agent-memory-deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vshulcz/deja-vu/releases/download/v0.25.0/deja-vu_0.25.0_registry.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "claude-codex-cursor-agent-memory-deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vshulcz/deja-vu/releases/download/v0.25.0/deja-vu_0.25.0_registry.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "claude-codex-cursor-agent-memory-deja-vu": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vshulcz/deja-vu/releases/download/v0.25.0/deja-vu_0.25.0_registry.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "claude-codex-cursor-agent-memory-deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vshulcz/deja-vu/releases/download/v0.25.0/deja-vu_0.25.0_registry.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "claude-codex-cursor-agent-memory-deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vshulcz/deja-vu/releases/download/v0.25.0/deja-vu_0.25.0_registry.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

About deja-vu — Coding Agent Memory & Session Search

The README says deja indexes the transcripts that coding agents already write to disk, such as ~/.claude, ~/.codex and Cursor's state database, and builds a local inverted index from them. Because it reads existing history in place, a session started months before installation can still be found, and no capture step has to be run ahead of time.

The index is served through a terminal search screen opened by running deja with no arguments, a CLI, a browser view generated by deja view, and an MCP server exposing a single deja tool with several modes such as recall, blame, fix and handoff. Lifecycle hooks can inject recalled context at session start, before edits and after failures. Credentials are replaced at index time with redaction markers, and the README states that indexing and search run locally with no remote inference.

Beyond search, it can hand a task from one agent to another, recover uncommitted edit spans that an agent overwrote, and map commits or lines back to the sessions that produced them. Optional semantic reranking works only if the user points it at a local or OpenAI-compatible embeddings endpoint.

What it does

Cross-agent session search
Searches the stored transcripts of many coding agents from one shared local index.
Existing history indexing
Reads transcripts already on disk, so sessions from before installation are searchable.
Agent handoff
Transfers goal, constraints, touched files and open work to another agent.
Uncommitted code recovery
Restores edit spans that an agent replaced before they were committed to git.
Local-only indexing
Indexing and search run on the machine, with credentials stripped at index time.
Compaction recovery
Injects a bounded recovery packet after context compaction or resets.

Good for

  • Finding how a bug was fixed in an earlier session with a different coding agent
  • Resuming an interrupted task in another agent without rebuilding context
  • Recovering code that an agent overwrote before it was committed
  • Tracing which past agent session wrote or changed a given line

Pricing

Open source

MIT licensed, free to run locally.

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

deja-vu — Coding Agent Memory & Session Search FAQ

Does deja send session data to an LLM?

The README says indexing and search run locally with no remote inference, and network requests occur only for explicit update, sync, version checks and configured embedding endpoints.

Which install methods are listed?

The README lists an install script for macOS and Linux, npx, Homebrew, Nix, go install, and Scoop or winget on Windows, plus a signed .mcpb bundle for desktop MCP clients.

Is semantic search required?

No. The README says lexical retrieval and MCP recall work normally when no embeddings endpoint is configured or reachable.

Is deja-vu — Coding Agent Memory & Session Search free?

Yes. deja-vu — Coding Agent Memory & Session Search is open source, so you can use and self-host it for free.

How do I add deja-vu — Coding Agent Memory & Session Search to Claude Code?

Run this command in your terminal: claude mcp add claude-codex-cursor-agent-memory-deja-vu -- npx -y https://github.com/vshulcz/deja-vu/releases/download/v0.25.0/deja-vu_0.25.0_registry.mcpb

What are the best alternatives to deja-vu — Coding Agent Memory & Session Search?

The closest alternatives to deja-vu — Coding Agent Memory & Session Search are Deja Vu, Agent Memory MCP, Cross-Agent Memory, CogniCore and Seamless.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers