快速开始
装十秒,建索引十秒,然后智能体就能查自己的历史了
安装
curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh deja install --auto
第二条命令做三件事:把 MCP 召回接到它在这台机器上找到的每一个智能体,在支持的地方打开会话启动时的自动召回,并建好第一份索引。也可以用 Homebrew(brew install deja-vu)或从 releases 直接下二进制。
建索引读的是你磁盘上已经有的会话记录,所以第一次跑完,你几个月前的工作就已经能搜到了——不需要提前记录任何东西。
先确认它看到了什么
deja sources deja stats
sources 列出它在每个工具下找到的路径和会话数;stats 给出索引里有多少会话、来自哪些项目、活跃度如何。如果某个工具没被认出来,支持矩阵里有它期望的路径和对应的环境变量。
自己搜一下
在终端里直接运行 deja,不带参数。第一次运行时它先建索引,进度界面会逐个列出正在读取的智能体,最新的会话能搜了就让你先进去。之后打开的是一个搜索界面:最上面是跟你未提交改动有关的会话,下面是这个项目最近的会话。
边打字边出结果。↵ 在匹配处打开会话阅读,r 回到写下它的那个智能体里恢复,o 换一个智能体接着做,? 列出其余按键,esc 或 q 退出。同样的搜索也能当普通命令用,方便脚本和管道:
$ deja "refresh token" [claude] api · Jul 8 · 8f31c0a9 — 2 matches login started failing after refresh token rotation; jwt kid mismatch in tests fixed by reloading jwks cache after rotateKey and adding a clock-skew test [codex] web · Jul 1 · b77d91e2 — 1 match refresh token cookie needed SameSite=Lax in local callback flow
想要文字摘要而不是界面,用 deja brief;设置 DEJA_TUI=0 后,单独运行 deja 也打印这份摘要。几条常用的命令:
deja "报错原文"—— 跨所有工具搜历史。deja fix "报错原文"—— 上次这个报错之后,真正跑通的是哪条命令。deja how "docker build"—— 你在这台机器上实际用过的调用方式。deja show <id>—— 打开某一个会话;deja last列出最近的。deja blame <文件>—— 哪些会话动过这个文件、当时在做什么。
让智能体自己去查
deja install --auto 已经把这条路接好了。之后是智能体自己发起召回,不用你开口:会话开始时、提问命中过去的工作时、改文件或执行命令之前、命令失败之后。哪个工具支持哪一个时机,见agents 指南。
只想手动用也完全可以:不接自动召回,deja 就只是一个命令行搜索工具。
关于隐私
索引和检索都在本地,没有网络路径,也不需要账号或 API key。建索引时凭据会被脱敏。会联网的只有你自己运行的 deja update、deja sync ssh、doctor 的版本检查和 deja embed(把文本发给你自己配置的嵌入服务),以及终端里敲的命令每天最多一次在后台查最新版本号,DEJA_NO_UPDATE_NOTICE=1 可以关掉——细节见隐私说明。
不想要了
deja uninstall --all rm -rf ~/.cache/deja
会话记录本来就是各个工具自己写的,deja 不动它们。