Log inSubmit server
Deja Vu logo

Deja Vu

by vshulcz

Indexes local coding-agent sessions for lexical search, automatic recall, secret redaction, and SSH-based cross-machine sync.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Deja Vu

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "vshulcz-deja-vu": {
      "command": "npx",
      "args": [
        "-y",
        "@vshulcz/deja-vu"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

vshulcz/deja-vu MCP server indexes session histories produced by coding agents such as Claude Code, Codex CLI, and opencode, then exposes recall through MCP. Its `deja` tool supports mode-dependent memory operations, while the command-line interface provides lexical search across projects and sessions. Reach for it when agents need access to earlier fixes, decisions, commands, and edited-file context without sending history to a cloud service. Installation can also configure session-start recall, redact secrets during indexing, and synchronize the local index over SSH.

Use cases

  • Search earlier sessions for a fix or design decision
  • Recall project context when starting a new agent session
  • Continue work from one coding agent in another
  • Sync local agent history between machines over SSH

Key features

  • Lexical search across agent session histories
  • Session-start and post-failure recall
  • Cross-agent shared local index
  • Secret and token redaction during indexing
  • SSH-based cross-machine synchronization
  • Session resume, handoff, deletion, and restoration

Tools1

What Deja Vu lets your agent do. Expand a tool for its parameters.

Self-reported~8 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

30/31 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @vshulcz/deja-vu (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1.3kStargazers on the source repository.
Last commitTodayMost recent push to the default branch.
Tools exposed1Callable tools this server registers over MCP.
Directory activity9 viewsConfig copies, upvotes, and views on AllMCPs.

How Deja Vu works

What vshulcz/deja-vu MCP server does

vshulcz/deja-vu turns coding-agent session history stored on disk into a searchable local memory layer. It can index sessions from Claude Code, Codex CLI, opencode, Cursor, and other supported agents, including history created before installation. The shared index lets one agent retrieve work performed in another agent, so decisions and previous fixes can follow a project across tools.

The indexed material includes conversation content as well as work context such as files opened during turns, commands and their exit statuses, and exact spans replaced by edits. Secrets and tokens are removed while the index is built. The system is local and does not require a model or hosted server; optional semantic recall can be enabled separately.

How it works

Running deja install --auto discovers supported agents, connects MCP recall where applicable, enables session-start recall where supported, and creates the initial index. Later sessions can receive relevant history when they open, and recall can also occur after a command fails. The MCP interface exposes a deja tool whose behavior depends on the selected mode.

The terminal interface searches across indexed sessions. A plain deja command opens the interactive search view, while deja brief or DEJA_TUI=0 produces a text summary. Searches can be narrowed by agent, relative date, or project. Results can be ordered by relevance or date, and a selected session can be resumed in its original agent or handed off to another one.

The index is shared across projects and agents on the same machine. deja sync ssh laptop transfers it between machines over SSH, without an intermediate cloud service. Sessions deleted by an agent remain available in a deleted view until explicitly removed or restored.

Setup and configuration

On macOS or Linux, install with:

Terminal
curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
deja install --auto

The installer places the binary in ~/.local/bin. If that directory is not already on PATH, use the path printed by the installer or start a new shell after updating PATH.

Other installation paths include Homebrew, Scoop, winget, npm, and Go. The documented Go command is:

sh
go install github.com/vshulcz/deja-vu/cmd/deja@latest

The project supports macOS, Linux, and Windows. Set DEJA_TUI=0 to disable the interactive terminal interface and print text output instead.

Tools and capabilities

  • Search indexed session history with lexical queries.
  • Recall earlier decisions, fixes, and project context through the deja MCP tool.
  • Start sessions with automatically retrieved history where the agent supports it.
  • Search by agent, date range, or project and sort by relevance or date.
  • Resume a session in its original agent or continue it in another agent.
  • Mark decisions as accepted or rejected with deja promote.
  • Delete or restore indexed sessions.
  • Synchronize history between machines over SSH.
  • Generate terminal or SVG statistics cards with deja stats --card.

Limitations and notes

Automatic recall depends on support from the agent being configured. The server works from session histories already saved on disk, so its available memory depends on what those agents have written and what has been indexed. Semantic recall is optional rather than required. The default installation flow is documented for macOS and Linux, while the binary is also available for Windows through the listed installation methods.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Deja Vu

vshulcz/deja-vu is an MCP server that connects to coding-agent session histories stored on disk, including Claude Code, Codex CLI, and opencode. Its `deja` tool provides mode-dependent recall and search capabilities, allowing agents to retrieve earlier fixes, decisions, commands, and project context from a shared local index.

Run the install script followed by `deja install --auto` on macOS or Linux. The script installs the binary, and the second command configures supported agents, enables session-start recall where available, and builds the initial index. Homebrew, Scoop, winget, npm, and Go installation methods are also available.

Yes, Cursor is among the coding agents supported by deja-vu. Its sessions can contribute to the shared index and receive MCP-based recall when configured. The README also names Claude Code, Codex CLI, and opencode among the supported agents.

Run `deja` to open the interactive search interface, or use `deja brief` for a text summary. Queries can be narrowed with agent, date, and project filters, while `deja search --sort date` sorts results chronologically for scripted use.

Yes, use `deja sync ssh laptop` to synchronize the local index over SSH. This transfers history between machines without using a cloud service.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDeja Vu AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/vshulcz-deja-vu?style=directory)](https://allmcps.com/mcp/vshulcz-deja-vu)
HTML Embed
<a href="https://allmcps.com/mcp/vshulcz-deja-vu"><img src="https://allmcps.com/api/badge/vshulcz-deja-vu?style=directory" alt="Deja Vu on AllMCPs" /></a>