RecallLoom 项目记忆
把项目背景、进展和下一步留在文件里，让不同会话和 AI 工具能接着工作。
- Star 数
- ★ 154
- 最近更新
- 2 个月前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 证据不足
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 长期软件项目的开发者在切换会话或模型后，需要恢复当前实现状态、决策和下一步。
- 不适合
- 需要任务编排或多 agent 执行的团队
- 只想保存聊天摘要的用户
这个 Agent 能做什么，适合哪些场景？
RecallLoom 是一个供 AI 编程工具使用的文件化项目记忆技能，将项目状态保存在项目旁边或项目内的 Markdown 和 JSON 文件中。通过 npx skills add 安装后，用户可在支持 skills 的工具中初始化项目记忆，并用自然语言或 rl-* 短触发词恢复状态、记录进展和检查文件。它使用 Python 3.10 及以上版本，项目记忆目录包含背景、当前摘要、每日记录及配置和状态文件。工具先读取当前事实和下一步，再按需查看历史材料；写入和修复遵循校验与确认路径。它不需要数据库、RAG 或后台服务，项目事实保存在本地工作区文件中。
安装 recallloom skill 后，在 AI 编程工具中对当前项目初始化记忆；已有有效 .recallloom/ 或 recallloom/ 目录时可继续使用。恢复时读取 context_brief.md、rolling_summary.md、每日日志及相关配置和状态，帮助会话从当前事实和下一步开始。用户可要求记录进展或决策，RecallLoom 通过受控脚本将长期事实写入项目记忆文件，并在写入前后执行修订、新鲜度和结构检查。rl-status 查看状态，rl-validate 检查连续性文件；daily-log cursor 异常可先预览再确认修复。
- 长期软件项目的开发者在切换会话或模型后，需要恢复当前实现状态、决策和下一步。
- 产品经理或协作者在持续编写 PRD、RFC 时，需要记录范围变化、原因和待定问题。
- 研究写作者在跨天继续项目时，需要保留论点、证据来源边界和写作进度。
- 同时使用 Codex、Claude Code 或 Gemini 等工具的用户，需要从同一套项目文件接力。
- 希望项目记忆留在本地工作区、便于审阅和迁移的个人或团队。
如何安装或部署这个 Agent？
前提是可使用 Node/npm/npx、Python 3.10+，并有能够安装或读取 skills 的 AI 编程工具。安装技能：
npx skills add https://github.com/Frappucc1no/recall-loom --skill recallloom更新已安装技能：
npx skills update如何使用这个 Agent？
首次在项目中使用时，选择 recallloom skill 并初始化：
@recallloom 初始化当前项目如果工具不支持 @ skill mention，可通过技能选择器选择 recallloom，或直接说“请用 RecallLoom 初始化这个项目”。接续工作时说“继续这个项目”或“从上次停下的地方继续”；也可使用短触发词：
rl-resume
rl-status
rl-validate记录进展时可说“记录今天的关键进展”。
这个 Agent 有哪些优点和局限？
- 项目状态保存在可读的 Markdown/JSON 文件中，便于审阅、diff、回退和迁移。
- 恢复先读取当前摘要、近期进展和下一步，避免每次都从完整仓库或历史材料开始。
- 支持 Codex、Claude Code、Gemini 等工具通过相应入口接力同一套项目记忆。
- 写入包含修订、新鲜度和结构检查，异常修复可先预览再确认。
- 需要安装 Node/npm/npx、Python 3.10+，并使用支持 skills 的 AI 编程工具。
- 用户需要在关键进展后记录并维护项目记忆；它不会自动整理整个仓库。
- 它不提供任务编排、issue 管理、RAG、知识库或后台执行服务。
- 多个 AI 工具的接入依赖各自支持 skills 或相应入口文件。
这个 Agent 与同类方案有什么区别？
RecallLoom 与 AGENTS.md、CLAUDE.md 等规则文件互补：规则说明工具应如何工作，RecallLoom 保存项目目前进展和下一步。它不同于 Claude Code 等工具的内置记忆，因为项目事实保存在可随项目迁移的文件中；也不替代 Beads 等任务图、LangGraph 等工作流执行框架，或 Chroma、Qdrant 等 RAG/向量数据库。若只需一次性交接，手写 HANDOFF.md 可能已足够。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| RecallLoom 项目记忆 当前 | 证据不足 | Agent 插件 / 技能免费 | ★ 154 | 2 个月前 | Python | Codex · Claude Code |
| Agent Deck | 76 · 表现良好 | 命令行工具免费 + 模型费 | ★ 1.1k | 今天 | Go | Codex · Claude Code |
| Coucou 智能体伴侣 | 73 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 5.5k | 今天 | Swift | Codex · Claude Code |
| mex 项目记忆 | 71 · 存在缺口 | 命令行工具免费 | ★ 1.8k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 当前材料主要是 README 摘录、许可证、安全政策和文档同步工作流；缺少被引用的 skill、脚本、协议及产品实现，无法据此完成产品级静态评估。
- README 所述本地存储、确认机制、写入守卫和兼容性均为文档主张，尚无实现材料可供核实。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.5.0 RecallLoom v0.5.0
发布说明摘录
RecallLoom v0.5.0 RecallLoom v0.5.0 is a stable write-path architecture release. It consolidates the previously distributed write flow into explicit final owners while preserving the protocol 1.0 sidecar contract and existing workspace compatibility. Changed - Managed write, daily-log append, and post-append summary sync now use one transaction orchestration boundary with explicit preview/apply, cut-point, post-write verification, provenance, and final-evidence handling. - Input acquisition is consolidated behind a host-neutral transport contract for …在 GitHub 查看 ↗ -
v0.4.8.3 RecallLoom v0.4.8.3
发布说明摘录
RecallLoom v0.4.8.3 RecallLoom v0.4.8.3 is a Windows write-recovery hotfix for the workspace write lock and for the failure guidance shown when a workspace becomes write-locked. Fixed - On Windows, a leftover .recallloom.write.lock file could make every later write fail. The process-liveness probe used to reclaim a stale lock relied on os.kill(pid, 0), which on Windows can terminate an unrelated live process or fail with an uncaught error that was reported as a damaged sidecar. Liveness is now probed through the Windows process API with a fail-safe …在 GitHub 查看 ↗ -
v0.4.8.2 RecallLoom v0.4.8.2
发布说明摘录
RecallLoom v0.4.8.2 RecallLoom v0.4.8.2 is a narrow compatibility hotfix for ordinary pre-D5 reviewed baselines created by the supported recovery-review path. Fixed - Full provenance validation could incorrectly treat an ordinary review_imported_baseline as current receipt-backed evidence and report a receipt/state mismatch. - Validation now verifies the exact stored proposal and review material against the metadata produced by the supported promotion path, including its legacy terminal-newline normalization, before recognizing that baseline as reviewed …在 GitHub 查看 ↗
常见问题
需要付费的模型或服务吗？
初始化后它会自动改业务代码或持续记录吗？
项目记忆保存在哪里？
.recallloom/ 或 recallloom/ 目录，以 Markdown 和 JSON 文件承载。隐私取决于你如何同步、提交或分享这些文件。它能管理任务和多 agent 执行吗？
如果项目已有两种 RecallLoom 目录怎么办？
.recallloom/ 和 recallloom/ 同时存在，应停止初始化并先检查项目状态。