本地优先的共享项目记忆层,让 Claude Code、Codex、Cursor 等编程智能体通过 MCP 读写同一份项目记忆。
timgordontg/engrim
本地优先、按项目隔离的 SQLite 记忆引擎,让 Claude Code、Cursor、Codex CLI 等多种 AI 编程助手共享项目决策与状态。
- Star
- 304
- Fork
- 16
- 未关闭 Issue
- 4
- 最近提交
- 上个月
这是什么?
engrim 是一个 Python 工具,为 AI 编程助手提供可跨会话、跨工具共享的项目记忆。它不再反复回放长对话记录,而是把架构决策、事实约束和当前任务等经过整理的记录保存在本地 SQLite 文件(~/.engrim/memory.db)中,并在新会话开始时注入一份有字数上限的记忆摘要。
它支持 Google Antigravity、Claude Code、Cursor、Windsurf、Codex CLI、GitHub Copilot CLI 和 OpenCode。能用生命周期钩子的工具通过钩子接入,其余工具则通过 MCP 服务(engrim serve --mcp)接入。每条记录都会标注写入它的智能体。检索结合 FTS5 全文搜索与 model2vec 静态向量,也可关闭向量部分只做词法检索。另外提供 engrim doctor 健康检查,用于验证数据库完整性和钩子配置,并有备份、合并、清理等命令行工具。
数据完全保存在本机,不发送遥测,也不做云端同步,数据库文件仅限所有者读写。
核心功能
- 01在同一项目下,多个 AI 编程助手共享一个本地 SQLite 记忆库。
- 02会话启动时注入有字数上限的记忆摘要,并可标记未完成任务的续接点。
- 03混合检索结合 FTS5 全文搜索与 model2vec 向量,也可切换为纯词法模式。
- 04每条记忆都记录写入它的智能体来源。
- 05engrim doctor 可检查数据库完整性与钩子配置,并支持自动修复。
- 06通过 stdio MCP 服务暴露 engrim_* 工具,并提供备份、合并、清理命令。
适用场景
- 清空聊天后,在 Claude Code 或 Cursor 中继续同一代码库,无需重复解释架构决策。
- 在同一仓库中切换使用多个 AI 编程助手,并共享同一份决策记录。
- 代码涉及敏感内容、不便发送给第三方记忆服务时,将项目记忆完全保存在本地。
- 通过合并导出的 SQLite 记忆库,在多次 CI 运行之间传递记忆。
快速上手
- 1
从 PyPI 安装 engrim
pip install engrim - 2
自动检测并配置已安装的 AI 编程代理环境
engrim setup - 3
检查安装健康状况
engrim doctor
使用前须知
- 需要 Python 3.10 或更高版本。
- 记忆存储在本地 SQLite 文件 ~/.engrim/memory.db 中,不支持跨机器云同步。
- Codex CLI 的钩子在运行前需要手动审查并信任。
收录于专题
标签
常见问题
- engrim 是什么?
- 本地优先、按项目隔离的 SQLite 记忆引擎,让 Claude Code、Cursor、Codex CLI 等多种 AI 编程助手共享项目决策与状态。 engrim 是一个 Python 工具,为 AI 编程助手提供可跨会话、跨工具共享的项目记忆。它不再反复回放长对话记录,而是把架构决策、事实约束和当前任务等经过整理的记录保存在本地 SQLite 文件(~/.engrim/memory.db)中,并在新会话开始时注入一份有字数上限的记忆摘要。
- engrim 可以免费使用吗?用的什么许可证?
- engrim 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- engrim 还在维护吗?
- 半年内有更新。engrim 最近一次提交是在 2026年9月26日。
- engrim 适合用来做什么?
- 清空聊天后,在 Claude Code 或 Cursor 中继续同一代码库,无需重复解释架构决策。 在同一仓库中切换使用多个 AI 编程助手,并共享同一份决策记录。 代码涉及敏感内容、不便发送给第三方记忆服务时,将项目记忆完全保存在本地。 通过合并导出的 SQLite 记忆库,在多次 CI 运行之间传递记忆。
- engrim 怎么安装和运行?
- 从 PyPI 安装 engrim: pip install engrim 自动检测并配置已安装的 AI 编程代理环境: engrim setup 检查安装健康状况: engrim doctor
- 在哪里获取 engrim?
- 源代码和安装说明在 GitHub 上:https://github.com/timgordontg/engrim
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
面向编程智能体的长期记忆层,基于本地 SQLite 存储,可在 Claude Code、Codex、Cursor 等工具间共享。
一段可粘贴进智能体配置的规则,用于防止 Claude Code、Codex 等编程智能体过度防御和过度构建。
面向 AI 智能体的长期记忆运行时,以 Markdown 文件为唯一事实来源,本地检索,可在 Claude Code、Codex 等工具间共享,无需 API Key。
一个经过校验的技能注册表,可为 Claude Code、Cursor、Copilot 等 AI 编程助手安装扩展技能。
面向 AI 编程助手的技能安装与管理 CLI/TUI,可安装、整理并分享技能库,附带作者精选技能。