# deja-vu

deja-vu searches coding agents’ session histories and brings useful past decisions into the current session. Use it to recover context instead of debugging an already solved issue again.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1300
- Author: vshulcz
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vshulcz/deja-vu
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/deja-vu

## What it does

The MCP server indexes session histories across coding agents and retrieves relevant context for the agent you are using now. Search can include older sessions, along with files opened during work and command results. That makes it useful when you need to find how a similar issue was handled before.

Agents share one index, so a result from Codex can inform work in Claude Code or Cursor. Context can arrive when a session starts and after a command fails. Everything runs locally, without a model or server, and secrets are removed as the index is built. Semantic recall uses embeddings only when enabled. For Claude Code setup, run `claude mcp add deja-vu -- npx -y @vshulcz/deja-vu`; the command uses `npx`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add deja-vu -- npx -y @vshulcz/deja-vu
```

### Codex

**Platform CLI**
```bash
codex mcp add deja-vu -- npx -y @vshulcz/deja-vu
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "deja-vu": {
            "command": "npx",
            "args": [
                "-y",
                "@vshulcz/deja-vu"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "deja-vu": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@vshulcz/deja-vu"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add deja-vu npx -y @vshulcz/deja-vu
```

## When to use it
- find an earlier fix in agent session history
- recover why a past decision was rejected
- carry context from Codex into Claude Code
- check which files changed during a past session

## Example prompts
- Find how we fixed the connection pool error in an earlier session.
- Recover why we rejected the previous approach.
- Search Codex history for this task and bring the relevant context into this session.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md