Repolode
kitfunso

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. 1

    用 npm 全局安装包

    npm install -g hippo-memory
  2. 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 数据每日更新。

相关项目