okf-memory/okf-agent-memory
Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.
深度介绍
它是什么
okf-agent-memory 是一个为 AI 编程代理设计的 Git 原生持久化记忆层。它用纯 Go 实现，无任何外部数据库或运行时依赖，为编码代理提供跨会话、可版本化的上下文记忆能力。
核心亮点
- 亚毫秒级搜索：内置 BM25 全文检索，内存中查询延迟低于 300 微秒
- 零依赖架构：单个二进制即可运行，天然适配容器与边缘环境
- 80% Token 削减：通过渐进式上下文披露机制，按需注入最相关的记忆片段
- 嵌入式 MCP 服务器：AI 代理可直接通过标准协议调用，无需额外适配层
为什么火
在 AI 编程工具同质化的当下，该项目精准击中了两个痛点：一是长会话中 token 消耗失控，二是代理无法跨任务保留工程决策。Git 原生设计让记忆可 diff、可回滚、可协作，这比传统向量数据库方案更轻量，也比纯文件缓存更结构化。
适合谁用
- 正在构建自定义 AI 编码代理的开发者
- 使用 Claude Code、Cursor 等工具但受限于上下文窗口的团队
- 关注隐私与数据主权，希望记忆完全本地化的企业用户
快速上手
go install github.com/okf-memory/okf-agent-memory@latest
okf-agent-memory init --project my-agent
okf-agent-memory mcp --port 8080
初始化后，代理即可通过 MCP 协议写入决策记录，并在新会话中按相关性自动检索。MIT 许可证允许自由集成到商业产品中。