kitfunso/hippo-memory

解决的问题

Hippo 是一个 AI 代理的内存层，可防止代理在切换不同 AI 工具（如 Claude Code、Cursor 和 Codex）时重复犯错或丢失上下文。与传统语义搜索系统保存所有内容不同，Hippo 实现了生物记忆模型，信息若未通过使用得到强化，将随时间衰减，从而确保代理仅保留高价值的教训和模式。

工作原理

Hippo 以 SQLite 为后端，配备 Markdown 镜像，并在三个生物层面上运行：仅会话的缓冲区、带时间戳的事件记忆存储，以及用于压缩模式的语义存储。

• 衰减与强化：记忆具有默认半衰期（例如 7 天）。回忆记忆会延长其半衰期，而将记忆标记为错误则会使其衰减更慢。
• 睡眠整合：hippo sleep 命令将相关事件记忆合并为稳定的语义模式，并清除已衰减的信息。
• 集成：通过钩子（例如修补 CLAUDE.md 或 .cursorrules）与代理框架集成，可从 ChatGPT、Slack 和 git 提交历史导入数据。
• 检索：记忆按相关性、强度和新近性排序，并可受令牌预算约束，避免上下文过载。

适用人群

使用多个 AI 编码代理和 CLI 工具，希望拥有一个持久、工具无关的内存存储，并能从项目历史中学习、防止重复错误的开发者。

主要亮点

• 生物记忆模型：实现衰减、通过检索强化，以及基于睡眠的整合。
• 工具无关：适用于 Claude Code、Cursor、Codex 以及任何 MCP 客户端。
• Git 集成学习：自动从 git 仓库的修复、回滚和错误提交中提取经验教训。
• 溯源与治理：每条记忆都记录其来源（类型、范围、所有者），并支持 GDPR 合规删除。
• 置信度层级：将记忆标记为已验证、已观察、已推断或已过期，帮助代理判断信任度。
• 结果反馈：允许用户标记回忆的记忆为有用或无用，以调整其衰减率。