rutter

产品简介

rutter 是一个跨 AI 工具的共享决策记忆，它记住你在 AI 会话里做过的决定，以及当时引用过的笔记，这样过了几个月回头查，或者换一个 AI 客户端继续干活时，都能把当时的思路接上。机制非常朴素：会话敲定某个决定时，客户端借助钩子自动写下一行记录；rutter 把这行记录追加到你自己笔记文件夹里一个带日期的文件中，同时记下每条被引用笔记的路径，以及该笔记在那一刻内容的哈希值。之后你在同一个或另一个已配置的 AI 工具里提问，就能拿回这条决定、它的日期和它引用的笔记。全部历史以纯 Markdown 形式存在你自己拥有的文件夹里，不依赖云端账号。

核心功能

• 自动捕获：会话结束时由钩子写入一行摘要，包含决定内容与引用笔记，无需手动整理，记录只追加不改写，早期决定与后来的决定并排保留。
• 哈希定位引用：每条引用都带着捕获时刻的内容哈希，笔记被改名但内容未变时仍能追踪到新路径；多个笔记哈希相同或找不到对应时，会把候选列出来交给你判断，而不是猜。
• 跨工具召回：提供检索、取笔记、看最近记录、看立场四类 MCP 工具，Claude Code、Grok、Codex、Antigravity CLI 均有接入路径，其他 MCP 客户端也能只用检索与召回能力。
• 两条校验分离：安装后分别验证捕获（当天文件出现在 _librarian 目录）与召回（客户端能据此回答），避免手写记录掩盖钩子没生效。
• 命令行直查：可用 npm 命令直接列出最近记录，输出包含时间、项目名、决定摘要与引用笔记的哈希状态。
• 限度公开：只捕获客户端写下的行；引用只说明会话列出了哪些笔记，不等于模型真读过；同一路径原地修改的笔记目前不会被标记；不确定的引用以未解析状态明示。

技术实现

记录以追加写的方式落在 _librarian 目录下的日期文件里，每行包含时间戳、项目名、摘要与引用数组。身份重放在索引时逐条检查死引用，用捕获时刻的 sha256 在当前笔记目录里定位文件，命中即绑定并写入台账，未命中则标记未解析。因为哈希基于内容而非路径，改名不改内容能被自动跟随，既改了内容又改名则无法确定是不是同一条笔记，工具选择如实呈现而不是猜测，文档把这类判断明确定义为使用者自己的决定。存储与检索全部在本地完成，项目以 MIT 许可的参考实现形式发布，命令、环境变量与目录沿用了早期项目名。

特色优势

决定是自动留痕的，使用者不需要养成写日志的习惯，钩子在会话收尾时落笔，记录只追加、不改写，早期决定始终和后来的决定并排保留。引用关系可以验证，哈希绑定的是内容而不是路径，笔记改名仍能跟随；无法确认时如实标为未解析并列出候选，绝不替使用者猜测。数据留在自己手里，全部历史是本地文件夹里的纯 Markdown，没有云端账号，没有厂商锁定，工具本身以 MIT 许可开放。文档还把边界写在前面：引用只说明会话列出过这份笔记，不代表模型真的读过；同一路径原地修改的笔记暂不标记；项目是个人参考实现，暂不提供支持承诺。

应用场景

• 在多个 AI 编码工具之间切换的开发者，把 Claude Code 里敲定的实现方案带到 Codex 继续推进，不必重新解释背景。
• 长期用 Markdown 做知识管理的人，几个月后回查当时为什么这么决定、依据的是哪几份笔记。
• 项目复盘与决策审计，按时间线还原决策顺序、笔记变化与未解析引用。
• 需要在多次 AI 会话之间保持连续性的写作与研究工作，让每次会话都能接上上一次的思路。

快速上手

1. 在 Claude Code 里安装插件，从官方目录或自有市场二选一，避免注册两套服务与钩子。
2. 指定笔记文件夹，再执行重载插件命令，没有笔记文件夹服务将无内容可读。
3. 用 MCP 状态命令确认 rutter 与四个工具已经列出。
4. 做一件真实的小事（光说一句 hello 不会留下值得回忆的记录），结束后检查笔记目录下是否生成当天日期的文件。
5. 直接问最近在忙什么，让客户端调用最近记录工具给出答案；Codex、Grok、Antigravity 则按文档走各自的克隆加钩子路径。

适用人群：以 Markdown 文件维护个人笔记、并愿意动手配置 AI 客户端（编辑设置文件、注册 MCP 服务、跑几条 npm 命令）的开发者与知识工作者；在多个 AI 编码工具之间切换、希望决策上下文可以延续的人。

出品方：个人开发者作品，MIT 许可，以参考实现形式公开，文档明确说明暂不提供支持承诺。

更新动态：文档记录了 2026 年 10 月 9 日的一次真实演示运行，包含决定、改名、重索引与未解析引用的完整输出；2026-10-10 以 Show HN 帖子发布，接入路径已覆盖 Claude Code、Grok、Codex 与 Antigravity CLI。

官网链接：https://ruttermemory.com/ （上手文档 https://ruttermemory.com/getting-started.html ）