适合谁
- 长期使用 Claude Code 或 Codex CLI 的开发者
- 需要记忆可搜索、可审计、项目隔离的团队
- 希望数据留在本地（SQLite/SQLCipher）的用户
R
66FMRS · C
一个功能完善、审计导向的本地编码代理记忆系统，单一 Rust 二进制覆盖 hooks、MCP、CLI 和 REST；亮点是可审计召回、项目隔离与治理能力。Cursor 支持仍为部分功能，性能声明标注为方向性而非公开结论。适合重视数据本地化与可追溯性的重度代理用户。
remem 是一个用 Rust 编写的单二进制工具，为 Claude Code 和 OpenAI Codex / Codex CLI 提供本地优先的持久化记忆。它通过钩子（hooks）、MCP 服务器、CLI 和本地 REST API 自动在会话开始时注入项目记忆，并在会话结束时在后台总结决策、缺陷修复理由、项目模式和偏好。数据存储在本地 SQLite，可选 SQLCipher 加密，无需外部数据库或托管服务。检索采用多通道倒数排名融合（RRF），结合 FTS5 BM25、实体索引、时间语义、LIKE 回退和受信任图谱扩展，支持中英文同义词扩展。它还提供记忆审计（remem why）、抑制/反馈治理、令牌用量与成本报告、用户上下文治理等能力。
工具能力
search
全文加向量融合搜索项目记忆，支持分支、类型、多跳等过滤。
get_observations
获取按主机/项目/会话归组的观察记录。
save_memory
显式保存一条记忆到本地存储。
workstreams
查看项目工作流的持续状态。
timeline
按时间线浏览记忆与事件。
search_raw
在原始会话记录归档中执行时间窗口分页搜索，返回与 CLI raw search 相同的 JSON 结构。
安装接入
1) 通过 Homebrew（brew install majiayu000/tap/remem）、npm（npm install -g @remem-ai/remem）、Cargo（cargo install remem-ai --bin remem）、安装脚本或源码编译安装 remem 二进制（macOS ARM 需 codesign 签名）。2) 运行 remem install --target claude / codex / all（Cursor 为 --target cursor，仅 macOS/Linux）。3) 重启代理，运行 remem status 和 remem search 验证；出现钩子问题时用 remem install --target claude --repair，排障用 remem doctor。
选型与风险
不适合谁
- Cursor 用户（v1 不支持会话初始化注入和自动捕获）
- 需要托管/团队共享记忆服务的场景
- 希望零配置、无需安装本地二进制的用户
所需权限
- 读写用户主目录下 ~/.remem/ 数据目录与加密数据库
- 修改 Claude Code / Codex / Cursor 的配置文件以注册钩子与 MCP 服务器
- 后台调用所配置的 LLM API 进行摘要与提炼（产生令牌费用）
- 可选本地 REST API 仅绑定 127.0.0.1 并需 Bearer 令牌认证
风险与副作用
- 记忆摘要调用外部 LLM 会产生持续的后台令牌成本
- Cursor 集成为 v1：自动捕获与 session-init 未启用，且配置更新非跨文件原子事务
- 存储的是项目与用户上下文信息，若密钥类内容意外进入需依赖内置脱敏扫描与抑制机制
- 命令强制（block 模式）仅限 Claude Code，Codex 上明确不支持
常见排障
- 运行 remem doctor 检查 Schema、密钥、数据库及各主机钩子/MCP 状态
- 出现 Claude Hook Integrity Warning 时执行 remem install --target claude --repair
- PATH 上存在多个 remem 二进制时按 doctor 提示统一安装路径
- 更换二进制后需重跑 remem install 以更新钩子命令
- 验证 ~/.claude/settings. 与 ~/.codex/hooks. 中 SessionStart 钩子命令是否正确
使用场景
跨会话自动召回上次的决策、缺陷根因与待办
可搜索、可审计的工程记忆替代手工维护的 MEMORY.md/CLAUDE.md
通过 hooks/MCP/CLI/REST 共享同一记忆存储
令牌用量与背景成本追踪
支持客户端
Claude Code完整支持
OpenAI Codex CLI完整支持
Cursor部分支持