engram

给编码智能体装上不会忘事的本地记忆库

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 7123

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类智能体

开发团队Gentleman-Programming

所属国家

官网地址https://engram.gentlemanprogramming.com

GitHubhttps://github.com/Gentleman-Programming/engram

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Go

技术栈/模型

GitHub 星标★ 7123

30天Star增速

HF 下载量

上线时间2026-02-16 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-11

浏览次数0

项目介绍

engram 是一个面向 AI 编程智能体的持久化记忆系统，用 Go 编写为单一二进制文件，底层采用 SQLite 加 FTS5 全文检索。它解决的核心问题是：Claude Code、Cursor、Codex 这类编码智能体每次会话结束后上下文全部丢失，导致重复解释项目背景、重复踩坑、跨会话无法积累经验。engram 把智能体的记忆从易失的对话窗口搬到本地数据库，通过 MCP 服务器被各类智能体调用，同时提供 HTTP API、CLI 和 TUI 三种访问方式。它不绑定特定智能体，任何支持 MCP 的客户端都能接入，数据完全存在本地，无需云端账号。核心能力包括：记忆的写入与检索、基于 FTS5 的关键词全文搜索、跨会话持久保存、多入口访问同一份记忆库。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 4 步

环境要求

macOS 或 Linux 环境（使用 Homebrew 安装方式）
已安装 Homebrew 包管理器
一个支持 MCP 的 AI 编程智能体（如 Claude Code、Cursor、Codex 等）

安装与启动步骤

1安装 engram

用 Homebrew 安装最新稳定版；Windows、Linux 或源码构建请改看 docs/INSTALLATION.md。
```
brew install gentleman-programming/tap/engram
```
2确定所用智能体

从 README 表格里找到自己在用的智能体名称，例如 claude-code、cursor、codex、gemini-cli。
3执行 setup 接入

把命令中的 claude-code 换成你的智能体名；该命令会写入对应的 MCP 与集成配置。
```
engram setup claude-code
```
4重启智能体

setup 完成后必须重启该智能体，才能加载新写入的 MCP 配置与集成项。

如何确认成功

setup 命令执行无报错并重启智能体后，MCP 工具即可用（README 未给出验证命令）

常见问题

Q：不用 Homebrew 怎么安装？

A：README 说明 Windows、Linux 和源码构建等全部安装方式见 docs/INSTALLATION.md，请按该文档操作。

Q：setup 后还需要手动启动服务器吗？

A：不需要。engram setup 会写好适用的 MCP 与集成配置，通常的 stdio-only 模式无需你启动服务器。

Q：Claude Code 重复运行 setup 会怎样？

A：会更新 marketplace 和已安装的用户级 engram@engram 插件；已存在的项目级或本地级副本不会更新，更新失败会导致 setup 失败。

Q：支持哪些智能体？

A：表格列出 Claude Code、Pi、OpenCode、Gemini CLI、Codex、Cursor、VS Code Copilot、Qwen 等，其他 MCP 客户端可按文档手动接入。

Q：setup 该用哪个子命令？

A：子命令按智能体取名，如 engram setup cursor、engram setup codex；用错名字无法写入正确配置。

注意事项

生产使用请从 GitHub Releases 安装最新稳定版，RC 版是预发布验证构建，仅在能接受风险时选用。
升级前请先阅读 docs/RELEASE-POLICY.md 中的发布策略。
其他安装方式、手动 MCP 配置与排错见 docs/INSTALLATION.md 和 docs/AGENT-SETUP.md。
Claude Code 更新成功后需再次重启，才能加载新的 hooks。

核心亮点

单一 Go 二进制，无运行时依赖，部署和迁移成本极低
同时提供 MCP、HTTP API、CLI、TUI 四种接入方式，覆盖面广
用 SQLite + FTS5 做本地存储与全文检索，数据不出本机，隐私可控

不足之处

仅支持 FTS5 关键词检索，缺少语义/向量检索，模糊意图召回能力有限
记忆的写入、去重、过期与冲突消解策略依赖使用者自行约定，缺少自动化治理

适用场景

让 Claude Code 记住项目的架构约定和踩坑记录，下次会话直接调用
团队把编码规范和历史决策写入共享记忆库，供多个智能体统一读取
个人开发者用 TUI 浏览和整理自己积累的智能体记忆，做知识复盘

替代项目

mem0、Letta、basic-memory

上一篇：kagent

下一篇：ai-passport