面向 AI 编程助手的本地优先持久记忆,将决策与经验存入 SQLite,并通过 MCP 提供给 Claude Code、Cursor 等客户端。
kitfunso/hippo-memory
面向编程智能体的长期记忆层,基于本地 SQLite 存储,可在 Claude Code、Codex、Cursor 等工具间共享。
- Star
- 784
- Fork
- 46
- 未关闭 Issue
- 29
- 最近提交
- 5小时前
这是什么?
Hippo 为编程智能体提供跨会话、跨工具的持久记忆。记忆保存在本机的 SQLite 数据库中,并镜像为可读的 markdown 文件,可以直接纳入 git 管理。默认使用 BM25 关键词检索,不需要下载模型,也不发起网络请求;向量嵌入是可选安装项。
与把所有内容保存后再搜索的做法不同,Hippo 会随时间调整记忆强度:记忆按可配置的半衰期衰减,被召回的记忆会被强化,错误类记忆衰减更慢,用户标记为好或坏的结果会提升或降低排序。运行 hippo sleep 可以把相关片段合并为一条记忆并清理重复项。
执行 hippo init 会为 Claude Code 和 OpenCode 安装钩子,在检测到 Codex 时写入其钩子配置,并向 AGENTS.md 或 CLAUDE.md 添加说明。任何 MCP 客户端都可以接入。项目支持导入 ChatGPT 导出、CLAUDE.md、.cursorrules 和 markdown 文件,也可通过 HTTP API 接收 Slack 和 GitHub 事件。
核心功能
- 01本地 SQLite 存储,并生成可提交到 git 的 markdown 镜像
- 02默认使用 BM25 检索,无需模型或网络调用
- 03记忆随时间衰减,被召回时强化,并可根据结果反馈调整排序
- 04为 Claude Code 和 OpenCode 提供钩子,并支持 Codex 与 AGENTS.md
- 05提供 MCP 服务和 HTTP API,便于各类客户端接入
- 06支持导入 ChatGPT 导出、CLAUDE.md、Cursor 规则和 markdown 文件
适用场景
- 在 Claude Code、Cursor、Codex 之间切换时保留过往踩坑经验
- 把项目约定和决策以可审阅、可 git 追踪的形式保存
- 将包含专有信息的项目记忆保留在本机,而非托管服务中
- 把已有的 CLAUDE.md 或 Cursor 规则导入共享记忆库
快速上手
- 1
用 npm 全局安装包
npm install -g hippo-memory - 2
在项目中运行 init 以创建存储并接入你使用的智能体
hippo init
使用前须知
- 要让每个智能体都自动记录,需要额外设置并完成宿主信任,例如在 /hooks 中信任 Codex 的钩子。
- 设置了 ANTHROPIC_API_KEY 时,sleep 会把记忆文本发送给 Anthropic 做事实提取,除非在配置中关闭。
- 向量嵌入是可选的,需要单独安装;默认使用 BM25 搜索即可。
- 需要 Node.js 22.16 或更高版本。
标签
常见问题
- hippo-memory 是什么?
- 面向编程智能体的长期记忆层,基于本地 SQLite 存储,可在 Claude Code、Codex、Cursor 等工具间共享。 Hippo 为编程智能体提供跨会话、跨工具的持久记忆。记忆保存在本机的 SQLite 数据库中,并镜像为可读的 markdown 文件,可以直接纳入 git 管理。默认使用 BM25 关键词检索,不需要下载模型,也不发起网络请求;向量嵌入是可选安装项。
- hippo-memory 可以免费使用吗?用的什么许可证?
- hippo-memory 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- hippo-memory 还在维护吗?
- 活跃维护中。hippo-memory 最近一次提交是在 2026年10月22日。
- hippo-memory 适合用来做什么?
- 在 Claude Code、Cursor、Codex 之间切换时保留过往踩坑经验 把项目约定和决策以可审阅、可 git 追踪的形式保存 将包含专有信息的项目记忆保留在本机,而非托管服务中 把已有的 CLAUDE.md 或 Cursor 规则导入共享记忆库
- hippo-memory 怎么安装和运行?
- 用 npm 全局安装包: npm install -g hippo-memory 在项目中运行 init 以创建存储并接入你使用的智能体: hippo init
- 在哪里获取 hippo-memory?
- 源代码和安装说明在 GitHub 上:https://github.com/kitfunso/hippo-memory
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
本地优先的共享项目记忆层,让 Claude Code、Codex、Cursor 等编程智能体通过 MCP 读写同一份项目记忆。
为编码智能体提供跨会话的持久记忆,自动记录会话活动并用 AI 压缩,再把相关上下文注入后续会话。
面向个人 AI 助手的本地长期记忆层,保留每一条原始对话、不做摘要,并以时间为主轴检索。
面向本地 Claude、Codex 等 Agent 会话历史的检索工具,提供 Rust 检索内核、JSON CLI 和桌面应用。
可自托管的长期记忆服务,让 AI 身份在不同客户端、模型与 Agent 之间保持连续。