ai-memory — AI 编码 Agent 的长期记忆(跨厂商交接)

GitHub: https://github.com/akitaonrails/ai-memory | ⭐1737 | Rust | MIT

核心思想

LLM 编码 agent 在会话结束时丢失上下文。ai-memory 给它们一个共享、持久的 wiki,由清理过的生命周期观测编译而成。会话结束时有相关观测变成连贯摘要,下一个 agent 收到有界交接包(handoff)。可选 ai-memory run 启动提供可移植的可见事件台账 + 原生按 harness 恢复,实现高保真的跨厂商连续性(Claude Code → Codex → OpenCode → Pi → Kimi Code → Command Code 等均可接)。

关键技术点

  • markdown-on-disk:wiki 是 git 仓库里的纯 markdown,可 grep、可用 Obsidian 打开、可用 rsync 备份。无向量库需要维护,无 write_note 仪式,无手动上下文加载。受 basic-memory 的 markdown-on-disk 源真模型启发。
  • 零摩擦生命周期捕获:hooks 即发即忘地捕获受边界约束、清理过的 prompt/工具生命周期/会话边界观测。用户 prompt 与压缩后摘要最多 16 KiB;通知与工具摘录最多 2 KB。
  • 受 Karpathy LLM Wiki 的”编译而非检索”模式启发,是 agentmemory 的 Rust 后继。
  • 支持 Hermes Agent:识别 agent=hermes 的 shell-hook payload 做会话归因;有社区维护的 ai-memory-hermes-plugin,并借鉴 Hermes 的自我改进循环(turn 后审查、审批门、curator 边界)。

为什么重要

解决 AI 编码 agent 生态的真实痛点——在多个厂商 CLI 之间切换时无需重新解释架构、失败路径与未决问题。与 gbrain / 我的记忆分层思路方向一致。

对 Hermes 的关联

Hermes Agent 是记载的”影响与先验”之一;社区插件把 ai-memory 生命周期捕获接入 Hermes。可作为 agent 记忆持久化的外部参照。