agent-memory

它做什么

• markdown 文件是事实源，SQLite FTS5 索引只是可删缓存——没有任何难以迁移的黑盒
• 召回返回 L0 清单（一行摘要、路径、锚点、得分），mem read 按大纲 / 摘要 / 全文逐级展开
• 三条读取通道：会话开始时确定性的 MEMORY.md 注入、BM25 召回（可选向量插件按 RRF 融合）、以及直接 ls/grep 目录
• 写入在对话边界触发，sleep-time 阶段按价值整理与遗忘——全程本地，无需 API key

什么时候用

适合被「agent 一关会话就失忆」困扰的人：把项目决策、偏好与复盘存进一个 Claude Code 和 Codex CLI 都能读写的库，下一次会话带着记忆开工，而不是从零开始。

如何上手

# 需要 Python 3.12+ 与 uv；尚未发布 PyPI 包
git clone https://github.com/tigerless-labs/agent-memory.git
cd agent-memory
uv sync --all-packages

mem init
# 库默认在 ~/agent-memory-store；
# 用 AGENT_MEMORY_STORE 换位置——记得在 agent 运行的每个 shell 里都 export

注意事项

版本 0.1.0、尚未上 PyPI，等于从源码 checkout 安装——接口可能变动。库路径必须在 agent 运行的每个环境里一致导出，否则各个环境会悄悄各建一个库。