Engram

AI 编码智能体的持久化记忆系统 一个大脑。支持本地或云端。与智能体无关（Agent-agnostic），单一二进制文件，零依赖。

安装 • Engram Cloud • 智能体配置 • 代码库指南 • 架构 • 插件 • 团队使用 • 参与贡献 • 完整文档

---

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

当会话结束时，你的 AI 编码智能体会忘记一切。Engram 为它赋予了一个大脑。

这是一个包含 SQLite + FTS5 全文搜索的 Go 二进制文件，通过 CLI、HTTP API、MCP server 和交互式 TUI 暴露接口。它适用于任何支持 MCP 的智能体 —— 无论是 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

配置你的智能体

智能体	一行命令
Claude Code	claude plugin marketplace add Gentleman-Programming/engram && claude plugin install engram
Pi	engram setup pi
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

关于每个智能体的完整配置、内存协议和压缩生存机制 → docs/AGENT-SETUP.md

就是这样。无需 Node.js，无需 Python，无需 Docker。一个二进制文件，一个 SQLite 文件。

Pi 插件包

Engram 拥有一个一等公民的 Pi 插件包：gentle-engram。

engram setup pi

它通过同一个本地或云端的 Engram 大脑，为 Pi 提供持久化的项目记忆、压缩恢复以及与其他 MCP 智能体的共享内存。该插件包是 Gentleman Programming 智能编码生态系统的一部分，与 Gentle-AI、SDD、skills 和 Engram Cloud 并列。

工作原理

1. 智能体完成重要工作（如 bug 修复、架构决策等）
2. 智能体调用 mem_save → 标题、类型、What/Why/Where/Learned
3. Engram 持久化到 SQLite 并进行 FTS5 索引
4. 下次会话：智能体搜索记忆，获取相关上下文

关于会话生命周期、主题键值和内存清理的详细信息 → docs/ARCHITECTURE.md

MCP Tools (19 个)

分类	工具
保存与更新	mem_save, mem_update, mem_delete, mem_suggest_topic_key
搜索与检索	mem_search, mem_context, mem_timeline, mem_get_observation
会话生命周期	mem_session_start, mem_session_end, mem_session_summary
冲突处理	mem_judge, mem_compare
实用工具	mem_save_prompt, mem_stats, mem_capture_passive, mem_merge_projects, mem_current_project, mem_doctor

参数完整的工具参考文档 → DOCS.md#mcp-tools-19-tools

终端 UI (TUI)

engram tui

导航：j/k 使用 Vim 键位，Enter 进入详情，c 复制内容到剪贴板 (OSC 52)，/ 进行搜索，Esc 返回。使用 Catppuccin Mocha 主题。

Git 同步

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

本地 SQLite 始终是唯一事实来源（source of truth）。云端集成是可选的复制功能。

engram sync                    # 将新记忆导出为压缩块
git add .engram/ && git commit -m "sync engram memories"
engram sync --import           # 在另一台机器上：导入新块
engram sync --status