MemoryCustodian

MemoryCustodian 是面向编码 agent 的 repo 原生记忆系统，以纯 Markdown 保存决策、约束和被否方案，让 agent 仅加载当前任务所需上下文。

AI知识管理

编程代理

AI开发者工具

访问网站

面向编码 agent 的项目记忆

MemoryCustodian 是面向编码 agent 的基于仓库的记忆系统。它帮助团队以纯 Markdown 保存决策、约束、被否方案和当前项目上下文，使未来会话只加载对手头任务重要的信息。

该产品旨在减少将项目历史反复粘贴到提示词或平台指令文件中的需要。它不把记忆保存在聊天记录里，而是将持久化上下文保存在仓库中，方便人类与代码一起审阅和更新。

核心能力

仓库原生 Markdown 记忆

将决策、约束、被拒绝的想法以及项目上下文存储在仓库中的纯 Markdown 文件里，方便人类像审查代码一样查看和版本管理。

选择性上下文加载

只加载当前任务所需的文件，从 `manifest.md` 和 `brief.md` 开始，再拉取与任务相关的记忆文件，而不是加载整个项目历史。

精简的 agent 启动引导

为 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 等文件使用轻量引导层，让平台特定指令引导 agent 访问持久化记忆，而不重复存储。

结构化记忆布局

创建默认记忆结构，包括 `manifest.md`、`brief.md`、`decisions.md`、`constraints.md`、`do-not-use.md` 和 `inbox.md`，并可选包含 `rules/`、`profiles/`、`areas/` 和 `archive/` 文件夹。

受控的维护工作流

提供用于初始化、修复、先预览后替换，以及受管控的引导块更新的 CLI 流程，为团队创建和维护记忆文件提供边界明确的方法。

多 agent 设置路径

支持本地插件和源码检出设置路径，包括 Codex、Claude Code 和 Gemini 的 agent 路径，使同一仓库记忆可在不同 agent 环境中复用。

常见工作流

开始新的编码会话
新的 agent 会话可以在提出更改之前恢复架构约束、偏好工作流和被否方案，从而减少每个任务开始时的重新学习。
维护共享项目记忆
团队可以把持久化项目上下文保存在仓库文件中，而不是聊天记录里，使决策更容易在代码评审中查看、更新和讨论。
在多个 agent 间使用同一记忆
在不同 agent 设置之间工作时，同一仓库记忆可以通过轻量平台引导和特定 agent 的安装路径加载，而不必手动重复。
为现有仓库引导或修复记忆
项目可以使用 CLI 初始化或修复其记忆文件，包括先预览后替换以及受管控的引导块更新，同时保持整理过的记忆不受影响。
恢复先前的实现约束
NightNotes 评估展示了 agent 如何使用仓库记忆，在规划实现之前恢复 JSON 存储决策、离线运行要求和标准库约束。

Pros and Cons

Pros

将项目记忆保存在仓库内的纯 Markdown 中，便于 diff 和检查内容。
只加载与当前任务相关的上下文，有助于避免把不必要的项目历史送入工作上下文。
通过 CLI 支持可重复的初始化和修复流程，包括针对现有设置的先预览后替换行为。
将持久化记忆与轻量 agent 引导分离，在保留项目特定知识的同时保持平台文件小巧。
提供了可复现的现场评估文档证据，表明 agent 曾从记忆中恢复出先前决策、约束和被拒绝的 SQLite 方案。

Cons

公开源码清楚展示了主要工作流，但除提到的 Codex、Claude Code 和 Gemini 路径外，对集成和外部 agent 支持只提供了部分细节。
README 强调需要谨慎初始化和整理，因此它不是一个无需项目设置和审查即可直接使用的即插即用记忆存储。

FAQ

MemoryCustodian 是用来做什么的？

它是面向编码 agent 的 repo 原生记忆系统。它将项目记忆存储在仓库内的纯 Markdown 文件中，并且只加载与当前任务相关的上下文。

它如何在项目中设置？

README 说明应使用 CLI 针对目标项目只初始化一次，例如使用 `memory-custodian init --project-root /path/to/project --agent all` 这样的命令。首次设置会创建 `brief.md` 脚手架以及位于 `docs/memory/` 下的核心记忆文件。

它支持哪些 agent 工作流？

文档描述了本地插件和源码检出工作流，并支持 Codex、Claude Code 和 Gemini 的 agent 设置路径。核心工作流基于仓库，而不是绑定到某一个托管服务。

运行时是否需要 Codex 或 GPT-5.6？

该产品围绕仓库中的轻量平台引导文件和持久化记忆来设计。它并未被描述为运行时依赖型基础设施，README 强调 Codex 和 GPT-5.6 用于构建和验证它，而不是作为运行时依赖。

它能在不覆盖整理内容的情况下更新现有记忆吗？

README 说明完整替换流程采用先预览再执行的方式，而修复模式会更新已知的生成元数据，同时不会覆盖人工整理的记忆。它还指出，规则、配置文件和 areas 等可选区域，除非清单明确包含，否则不会进入默认上下文。

Quick Facts

类别: 开发者工具
产品类型: 仓库原生项目记忆系统
主要用户: 使用 agent 辅助仓库的编码 agent 和开发者
来源域名: github.com
定价: 提供免费和付费 GitHub 方案；该仓库在 GitHub 上公开可访问
支持的设置路径: Codex、Claude Code、Gemini 和源码检出工作流