oleksiijko/pmb

Local-first persistent memory for AI coding agents (Claude Code, Cursor, Codex) over MCP. Decisions, lessons and facts live in one SQLite file on your disk. Offline, multilingual.

它解决了什么

AI 编码代理经常在会话之间忘记关键的项目背景、决策和教训，迫使用户一次又一次重新解释相同的约束和项目结构。PMB 提供本地优先、持久的记忆系统，允许代理在重启和模型升级后仍能回忆起过去的决策、个人事实和项目特定规则。

它如何工作

PMB 充当 MCP（Model Context Protocol）服务器，连接 Claude Code、Cursor、Codex 等代理。它使用混合检索系统，结合 BM25（词汇搜索）、密集向量（语义搜索）和实体图，在毫秒级获取相关上下文。

数据本地存储，SQLite 作为主要真相来源，向量索引使用 LanceDB。为确保记忆真正被使用，PMB 在协议层面使用“hooks”在模型开始处理请求前将相关上下文注入代理的提示，并通过“ambient memory”自动记录代理的工作，无需显式的工具调用。

适用人群

使用支持 MCP 的 AI 编码代理的开发者，希望工具记住项目特定的决策、教训和结构，而不依赖云端记忆或 API 密钥。

亮点

  • 本地优先隐私：所有数据都保存在用户机器的本地工作区；无需云账户或 API 密钥。
  • 协议层 Hook：自动将记忆注入代理的提示，消除代理需要记得调用记忆工具的需求。
  • Ambient Memory：自动记录代理活动（编辑、测试、提交），即使代理未显式记录记忆也能捕获工作。
  • 混合召回：结合词汇、语义和图形搜索，实现快速、多语言检索（支持 50+ 语言）。
  • 可视化仪表盘：包含本地 Web UI，将项目记忆以实时实体图和时间线可视化。
  • 自我改进循环：跟踪提出的教训是否真的被代理遵循，允许用户修剪“死”规则。