deja-vu

为什么需要

用 Claude Code、Codex 写代码几个月后，磁盘上散落着成百上千个 JSONL 会话记录——里面有你解决的 bug、调过的 prompt、走过的弯路。每次开新会话，AI 不知道你已经踩过这些坑，从零开始问。deja-vu 把这些沉睡的会话文件索引起来，让 AI 通过 MCP 协议随时调取历史经验。

和 mempalace、supermemory 不同：deja-vu 不需要前置配置、不调用 LLM、不依赖 embedding——它直接索引已经在磁盘上的会话历史。LongMemEval-S 检索基准 hit@1 84.9%，单二进制 1.5ms 检索 3.5GB 数据。

怎么用

npm install -g @vshulcz/deja-vu
deja-vu

启动后自动扫描 ~/.claude、~/.codex、~/.opencode 等常见 Agent 会话目录，建立索引。通过 MCP 协议暴露给任何 Agent：

// 在 Claude Code / Codex 配置中添加
{
  "mcpServers": {
    "deja-vu": {
      "command": "deja-vu",
      "args": ["serve"]
    }
  }
}

Agent 询问时直接调用 deja_search(query) 即可拿到历史会话片段。

使用案例

独立开发者用 Claude Code 做了 3 个月出海 SaaS，磁盘上有 800+ 会话文件。某天遇到 OAuth 回调问题，问新会话"上次怎么解决 Stripe webhook 签名验证的？"——deja-vu 立刻返回 3 周前的会话片段，连当时的 prompt 和修复 commit 都找到。

另一个场景：团队成员离职时把所有会话历史留给接手的人，deja-vu 让接手者第一天就能查询"这个项目之前为什么用 Prisma 不用 Drizzle"，不用看 README。

注意事项

• 完全免费开源，MIT 协议，单 Go 二进制
• 仅支持本地模式，所有索引和数据在本地，隐私可控
• 通过 SSH 在多台机器之间同步索引（自有协议）
• 不支持实时监听新会话（只索引已有文件），需要定期重扫
• 目前覆盖 Claude Code、Codex、OpenCode，Cursor/Windsurf 等支持在路线图