A portable memory protocol for AI agents — load it as standing rules; a curation discipline + reference spec + optional cap hook.
Stars 174 +2Forks 11许可证 MIT更新 2026/8/20
Engramory 是小规模本地智能体记忆的文件协议，用一组短小 Markdown 事实文件和一份常驻索引保存内容，并通过宿主规则文件要求模型遵守整理纪律。它不使用数据库、向量、服务端或额外基础设施。
项目附带校验器与可选索引容量 Hook，但目前仍是实验版本。Hook 只拦截匹配的直接编辑工具，shell、MCP、外部编辑器和同步客户端都能绕过，也假设同一时间只有一个写入者，因此不能当作强制可靠的跨智能体记忆层。
核心能力
- 用一组短小 Markdown 事实文件和一份常驻索引保存小规模本地智能体记忆
- 把策展纪律作为常驻规则写入宿主规则文件，要求模型写前查重、能改则改、发现错误则删
- 提供校验器 tools/engramory_doctor.py 与可选的索引容量 PreToolUse hook
- 可把任意宿主指向另一智能体已写入的记忆库做只读读取
如何开始
- 1确认 Python
hook 与 tools 脚本需要 Python 3.9 及以上。macOS 与多数 Linux 请用 python3，Windows 请用 python
- 2用 Codex 初始化接线
把纪律写入 AGENTS.md，创建记忆模板，可选安装完整协议为 Codex skill，记忆目录在项目内时追加 gitignore
python tools/engramory_init.py codex --project-root /path/to/project --install-skill
使用前确认
当前为 0.10.0 实验版本。硬性索引上限 hook 只拦截匹配的直接编辑工具，shell、MCP、外部编辑器和同步客户端都能绕过。纪律靠模型遵守，不保证每个任务都生效。假设同一时间只有一个写入者，暂时不能当作强制可靠的跨智能体记忆层。同名其他仓库与本项目无关。智能体应先读 AGENT-SETUP.md，不要直接照安装步骤动手。不要把 Engramory 直接接管 Codex 原生 Memories。记忆库本身保持 git-ignore。
Star 增长
数据来源：定期同步保存的 Star 快照；增长不构成质量、安全或官方背书。
GitHub Topics
相关项目
该仓库不是已验证的可安装插件；请查看仓库 README 了解使用方式。
收录或清单确认都不等于本站验证。该项目因仓库添加了 dsh-plugin Topic 而自动进入目录。相关度与排查提示由公开信息自动生成，不构成质量、安全或官方背书；本站没有替你安装、运行或审核其兼容性和安全性。第三方项目可能在 Harness 进程中运行。请自行审查源代码、依赖、许可证、安装方式和权限；Star 数量不构成质量、安全或官方背书。