Engram

AI 编程助手的持久化记忆系统
Agent-agnostic（支持任意 Agent）。单一二进制文件。零依赖。

安装指南 • Agent 设置 • 架构原理 • 插件 • 参与贡献 • 完整文档

engram /ˈen.ɡræm/ — 神经科学：大脑中记忆的物理痕迹。

你的 AI 编程助手在会话结束时会遗忘所有内容。Engram 为其赋予了大脑。

这是一个包含 SQLite + FTS5 全文搜索 的 Go 二进制文件，通过 CLI、HTTP API、MCP server 和交互式 TUI 暴露接口。它适用于任何支持 MCP 的 AI Agent — 包括 Claude Code、OpenCode、Gemini CLI、Codex、VS Code (Copilot)、Antigravity、Cursor、Windsurf 等等。

Agent (Claude Code / OpenCode / Gemini CLI / Codex / VS Code / Antigravity / ...)
    ↓ MCP stdio
Engram (single Go binary)
    ↓
SQLite + FTS5 (~/.engram/engram.db)

快速开始

安装

brew install gentleman-programming/tap/engram

Windows、Linux 及其他安装方式 → docs/INSTALLATION.md

设置你的 Agent

Agent	一键命令
Claude Code	`claude plugin marketplace add Gentleman-Programming/engram && claude plugin install engram`
OpenCode	`engram setup opencode`
Gemini CLI	`engram setup gemini-cli`
Codex	`engram setup codex`
VS Code	`code --add-mcp '{"name":"engram","command":"engram","args":["mcp"]}'`
Cursor / Windsurf / 任意 MCP	查看 docs/AGENT-SETUP.md

各 Agent 的详细配置、内存协议及压缩策略 → docs/AGENT-SETUP.md

就是这么简单。不需要 Node.js，不需要 Python，不需要 Docker。一个二进制文件，一个 SQLite 数据库文件。

工作原理

1. Agent 完成重要工作（如 Bug 修复、架构决策等）
2. Agent 调用 mem_save → 记录标题、类型、What/Why/Where/Learned
3. Engram 持久化存储到 SQLite 并建立 FTS5 索引
4. 下次会话：Agent 搜索内存，获取相关上下文

关于会话生命周期、主题键值及内存管理的详细说明 → docs/ARCHITECTURE.md

MCP 工具

工具	用途
`mem_save`	保存观察结果
`mem_update`	根据 ID 更新
`mem_delete`	软删除或硬删除
`mem_suggest_topic_key`	为演进中的主题提供稳定键值
`mem_search`	全文搜索
`mem_session_summary`	会话结束时保存总结
`mem_context`	获取近期会话上下文
`mem_timeline`	按时间顺序深入查看
`mem_get_observation`	根据 ID 获取完整内容
`mem_save_prompt`	保存用户 Prompt
`mem_stats`	内存统计信息
`mem_session_start`	注册会话开始
`mem_session_end`	标记会话结束

完整工具参考 → docs/ARCHITECTURE.md#mcp-tools

终端界面 (TUI)

engram tui

导航操作：j/k (Vim 快捷键)，Enter 进入，/ 搜索，Esc 返回。内置 Catppuccin Mocha 主题。

Git 同步

在不同机器间共享记忆。使用压缩块传输 — 无合并冲突，无大文件。

engram sync                    # 导出新的内存为压缩块
git add .engram/ && git commit -m "sync engram memories"
engram sync --import           # 在另一台机器：导入新块
engram sync --status           # 检查同步状态

完整同步文档 → DOCS.md

CLI 参考

命令	描述
`engram setup [agent]`	安装 Agent 集成
`engram serve [port]`	启动 HTTP API (默认: 7437)
`engram mcp`	启动 MCP 服务器 (stdio)
`engram tui`	启动终端界面
`engram search`	搜索记忆
`engram save`	保存记忆
`engram timeline`	时间轴上下文
`engram context [project]`	近期会话上下文
`engram stats`	内存统计
`engram export [file]`	导出为 JSON
`engram import`	从 JSON 导入
`engram sync`	Git 同步导出
`engram version`	查看版本

文档

文档	描述
安装	所有安装方法及平台支持
Agent 设置	Agent 配置及内存协议
架构	工作原理、MCP 工具及项目结构
插件	OpenCode 和 Claude Code 插件细节
对比	Engram 与 claude-mem 的对比
参与贡献	贡献工作流及标准
完整文档	完整的技术参考

许可证

MIT

灵感来源于 claude-mem — 但它是 Agent 无关的、更简单且架构不同。

Gentleman-Programming/engram