知识记忆#代码智能体#记忆

deja-vu:从本机会话历史里找回编程智能体做过的事

把磁盘上 Claude Code、Codex、Cursor 等智能体的历史会话建成本地索引,新会话能查到过去的修复和决定,不调用模型。

项目与安装文档

查看项目

https://github.com/vshulcz/deja-vu

三个月前你和 Claude Code 花了一下午才修好的 JWT 刷新问题,今天在 Codex 里又遇到了,而它对此一无所知。其实那次会话的完整记录一直躺在你的磁盘上。deja-vu 做的就是把这些现成的会话文件建成索引:装好当天就能搜到几个月前的历史,任何一个智能体都能通过 MCP 查到另一个智能体当时的结论。

能做什么

  • 一个 MCP 工具:服务器只暴露 deja,用 mode 参数切换功能,比如 recall 按问题或报错字符串返回匹配片段(上限 4 KB)。项目自测定义只占约 477 token。
  • 跨智能体共用:支持 38 个编程智能体和客户端,包括 Claude Code、Codex CLI、Cursor、opencode、Gemini CLI,在一个里找到的修复,换另一个也能查到。
  • 自动召回:开启后在会话开始、编辑文件前、命令失败后主动送上相关历史,不需要智能体自己想起来查。
  • 记录做过什么:索引的不只是对话,还有每轮打开的文件、执行的命令及退出码;deja promote <id> --state rejected 能把被推翻的决定标出来。
  • 本地且脱敏:没有模型、没有嵌入、不需要服务器,建索引时会把密钥、令牌、JWT 等替换成 [redacted:<kind>]。

适合谁

  • 同时用好几个编程智能体,经常在不同工具里重复踩同一个坑的开发者。
  • 会话被压缩(compaction)后关键细节丢失、想把命令和决定找回来的重度用户。

接入方式

macOS 和 Linux 上两条命令即可,第二条会把 MCP 接入检测到的所有智能体并建好首个索引:

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

也可以 brew install deja-vu,Windows 用 scoop install deja-vu 或 winget install vshulcz.deja-vu。

编辑点评

截至 2026-10-06 约 1100 star,2026 年 7 月才创建,更新非常频繁。它和其他记忆服务器的根本区别是不需要“从零开始积累”:数据源就是你已经有的会话记录,单个 Go 二进制、纯词法检索,不花一分钱 token。适合编程场景,但不适合聊天助手那类个人偏好记忆。两点提醒:一是 deja install 会改写多个智能体的全局指导文件(可用 --no-guidance 关闭),装之前先看清楚它要动哪些文件;二是脱敏只作用于索引,原始会话文件里的密钥还在,项目提供 deja secrets 帮你找出来。许可证为 MIT。