
Reverie:为编程 agent 提供本地记忆,可学习用户修正
来源标题:Show HN: Reverie – local memory for coding agents that learns your corrections
Reverie 是一个面向编程 agent 的工程记忆工具,跨 Claude Code、Codex CLI、opencode 和 Cursor 使用,数据存于单个本地 SQLite 文件。它会记住用户设定的规则、决策和偏好以及代码的实际改动,在会话开始时按需检索给下一个 agent,而不预先注入提示,以免 agent 过度信任旧笔记。项目目前处于早期阶段,仅在少数项目上使用过。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Reverie 是为编码 agent 打造的工程记忆。它支持 Claude Code、Codex CLI、opencode 和 Cursor,所有数据都存放在同一个本地 SQLite 文件中。它会记住你说过的话(规则、决策、偏好)以及代码真正发生了哪些改动,在会话开始时把这些信息交给下一个 agent,并在该 agent 编辑相关文件时再次提供,随着代码演进保持这些信息始终准确,还能让你接着做另一个工具没做完的会话。
状态:早期阶段。Reverie 目前只在少量项目上使用过。预计会有粗糙之处,遇到失败请告诉我们。
一次终端崩溃打断了长时间会话,状态丢失了。许多记忆工具会在会话开始时把过去的笔记加载进 prompt。在一次非正式测试中,这导致 agent 更相信笔记而不是眼前的代码。Reverie 改为按需检索,并且会告知 agent 先阅读代码。
一条命令(macOS 和 Linux;只需 git 和 curl,别的都不需要,因为它自带 Python): curl -LsSf https://raw.githubusercontent.com/muditsarda1122/Reverie/main/scripts/install.sh | sh 如果你没有 uv,它会为你的用户安装 uv,把 Reverie 作为独立工具安装,然后运行 reverie install。在我们的 MacBook 测试中,大约花了一分钟,大部分时间用于下载约 90 MB 的 embedding 模型(只需下载一次);安装占用约 170 MB。如果你愿意,可以先读一下脚本:它很短,除此之外不做别的事。
然后在环境中设置一个 LLM API key(Anthropic、OpenAI、Gemini、OpenRouter 或 OpenCode Zen;Reverie 会使用它找到的那个,见 Model providers),并重启你的 agent。就这些。这个 key 是 Reverie 用于自身提取调用的,因此在每个 agent 下行为一致。
平台:macOS 和 Linux(每次改动都经过测试)。在原生 Windows 上,安装器(scripts/install.ps1)和 CLI 在 CI 中运行,但我们的 1,443 个测试中仍有 68 个在 Windows 上失败,主要是路径处理问题,因此请把 Windows 视为实验性支持,优先使用 WSL。
想用自己的工具?包名是 reverie-mem(命令是 reverie):uv tool install reverie-mem 或 pipx install reverie-mem,然后运行 reverie install。
想手动安装?需要 Python 3.12 和 git: git clone --depth 1 https://github.com/muditsarda1122/Reverie.git cd Reverie python3.12 -m venv .venv && source .venv/bin/activate pip install -e . reverie install reverie install 会检测你安装了哪些 agent,把 MCP server 接入每一个,写入每个 agent 的指令以及 /reverie-review 和 /reverie-status 命令,创建 ~/.reverie,并打印它具体写了什么的摘要。然后它会启动 server 并检查其是否响应,并报告每个 agent 的成功或失败。之后请重启每个 agent。
安装器会把绝对路径写入每个 agent 的配置,这样 agent 就能在 virtualenv 之外找到 server。如果你移动了 Reverie 文件夹(手动安装),请重新运行 reverie install。
想看看安装器会改什么而不实际写入,运行 reverie install --dry-run。非交互模式:reverie install --all 配置所有检测到的 agent,--only claude_code,codex 只配置你指定的那些。
在 Reverie 能提取任何内容之前,你需要一个 LLM provider key。在运行安装器之前设置好,或选择“Local via Ollama”。见 Model providers。
在任意项目中打开你的 agent。Reverie 默认在所有仓库中启用;用 reverie disable 让某个仓库退出(用 reverie enable 重新启用)。已有的记忆会保留。
正常写代码即可。Reverie 会在后台记录你的 prompt(已脱敏)并提取规则、决策和偏好。无需事先审查即可生效;每一项都可以用 reverie undo <id> 撤销,reverie digest 会列出新增的内容。
新会话,任意工具。会话开始时你的规则和一份简短索引会送达;与某个文件相关的条目会在 agent 编辑该文件时送达。
会话被中断了?在下一个 agent 中说“my previous session got cut off, run reverie resume”。它会打印你的规则、你发送过的每一条 prompt(原文,已脱敏)以及 git 状态,无论该会话运行在哪个工具中。
保持准确。reverie stale check(在新增 commit 后也会自动运行)会标记出被 commit 推翻的条目。reverie stale accept|keep 用于解决它们。
你会看到什么
经过几次会话后,reverie digest 会列出 Reverie 记住的内容(这里来自一个临时仓库):
3 item(s) added since the beginning:
[f48988f3] rule (you said)
Never commit directly to main; open a PR.
[d3c7b2c5] preference (you said)
Use pytest, not unittest, for new tests.
[a4c5003b] decision (you said)
Chose Postgres advisory locks over Redis for job dedupe: one less service to run.
Undo any of them with reverie undo <id>.
reverie status 会显示该仓库持有什么,并在看不到 key 时给出警告:
Memory for this repo: 3 items (1 rule, 1 preference, 1 decision). reverie digest lists what was added recently.
!! No LLM key found (OPENCODE_ZEN_API_KEY is not set in this shell).
Reverie records your prompts, but it cannot extract rules or decisions without a key.
如果 reverie status 显示该警告,说明目前还没有提取任何内容。把 key 放到你的 shell 配置文件中并重启你的 agent(从桌面图标启动的 agent 看不到只在终端中设置的变量)。
Agent
记忆由谁送达
prompt 和回答由谁捕获
Claude Code
hooks(会话开始、每次编辑前)+ MCP
hooks + transcript importer
opencode
plugin(规则写入 system prompt)+ MCP
plugin + transcript importer
Codex CLI
hooks(reverie install 会通过 Codex 自己的 API 替你批准;--no-trust-codex-hooks 则留给 /hooks 处理)+ MCP
hooks(批准后)+ transcript importer
Cursor
MCP
transcript importer(hooks 尚未验证)
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。