deja-vu

让编码代理记住你项目的历史，不用每次重新解释

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 156 🐛 待处理 29 👀 关注 5

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1341

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，Go单二进制本地运行

项目预览

项目数据

分类智能体

开发团队vshulcz

官网地址https://vshulcz.github.io/deja-vu

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

定价模式🏷️完全免费

价格说明开源免费，Go单二进制本地运行

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Go

技术栈/模型agent-memory,ai-memory,claude-code,claude-memory,cline,codex,coding-agents,cursor,deepseek-harness,gemini-cli-extension,github-copilot,kimi-code,mcp,mcp-server,opencode,persistent-memory,qwen-code,session-history,windsurf,zed-extension

GitHub 星标★ 1341

上线时间2026-07-14 00:00:00

代码更新2026-10-31

仓库体积43.6 MB

本站数据更新2026-11-01

维护状态活跃

收录时间2026-11-01

浏览次数0

项目介绍

deja-vu 是一个用 Go 编写的编码智能体记忆工具，面向 Claude Code、Codex、Cursor 等 40 多种编码代理。它直接读取磁盘上已有的会话历史，为代理提供跨会话的长期记忆，解决每次对话都从零开始、重复解释项目背景的问题。核心能力包括：本地全文检索历史会话、通过 MCP 协议向代理暴露记忆查询接口、用 hooks 在会话开始或结束时自动注入或归档上下文。整个方案不调用 LLM，不依赖云端，所有数据留在本机，以单个 Go 二进制分发，安装和运行成本低。适合希望让编码代理记住项目约定、历史决策和踩坑经验的开发者，尤其适合多代理混用、需要统一记忆层的团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-11-01 · 当前星标 ★ 1341

技术标签

agent-memory ai-memory claude-code cline codex

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

macOS 或 Linux 终端环境（安装脚本为 shell 脚本）
把 ~/.local/bin 加入 PATH，安装脚本会把 deja 二进制文件放到这里
用 go install 方式安装时，需要本机已安装 Go 工具链
Windows 需要能使用 Scoop 或 winget 包管理器

安装与启动步骤

1安装 deja 二进制

用官方脚本安装，二进制文件会被放到 ~/.local/bin，整个过程约十秒。
```
curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh
```
2让 PATH 生效

如果 ~/.local/bin 还不在 PATH 中，就执行脚本打印的 next: 行（其中包含完整路径），或者新开一个终端。
3自动接线并建索引

自动为检测到的代理接入 MCP 记忆查询，并在支持的代理上开启会话开始自动回忆；同时构建首个索引，约十秒。
```
deja install --auto
```
4检索历史会话

直接运行 deja 即可自行检索历史会话；也可以在新开的代理会话里让它查记忆，例如问「jwt refresh rotation 我们处理过吗」。
```
deja
```
5Windows 安装

Windows 上安装脚本会报 unsupported OS，请改用 Scoop 或 winget 安装，也可以把 release 里的 deja.exe 放进 PATH。
```
scoop install deja-vu
winget install vshulcz.deja-vu
```
6检查接线状态

查看各代理的 MCP 接线是否完成；只安装二进制文件而未运行 deja install 时，显示 config missing 或 not-wired 属于预期。
```
deja doctor
```

如何确认成功

运行 deja 能检索出历史会话内容；运行 deja doctor 可查看各代理的 MCP 接线状态。

常见问题

Q：Windows 上执行安装脚本报 unsupported OS 怎么办？

A：该脚本是 shell 脚本，不支 Windows。改用 scoop install deja-vu 或 winget install vshulcz.deja-vu，也可下载 release 里的 windows zip，把 deja.exe 放进 PATH。

Q：第二条命令提示 command not found？

A：说明 ~/.local/bin 尚未加入 PATH。执行脚本打印的 next: 行（带完整路径），或在 PATH 行写入后新开一个 shell 再运行。

Q：不运行 deja install 能用吗？

A：可以，索引、搜索、show、ctx、blame、--json 和脱敏都不依赖它；只是 MCP 记忆查询和会话开始自动回忆不会被接入。

Q：不想让安装改写各代理的引导文件？

A：使用 deja install --all --no-guidance 跳过引导文件写入；重复运行只会重写 deja 的 skill 或标记块，不影响周围的用户内容。

Q：不想每次会话开始就自动回忆？

A：改用 deja install --all，它相当于 --auto 但不开启会话开始回忆，由代理自行决定何时调用记忆。

注意事项

整个工具在本机运行，不调用 LLM、不依赖云端，会话数据留在本机。
除脚本安装外，还可用 brew install deja-vu、go install github.com/vshulcz/deja-vu/cmd/deja@latest 或 npx @vshulcz/deja-vu "query" 免安装试用。
deja warmup 会在 ~/.agents/skills/deja-search/SKILL.md 留下一份 skill，教代理在没有 MCP 时使用命令行检索。
桌面类应用可从 latest release 下载 .mcpb 包，其中自带二进制。