Repolode
timgordontg

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. 1

    从 PyPI 安装 engrim

    pip install engrim
  2. 2

    自动检测并配置已安装的 AI 编程代理环境

    engrim setup
  3. 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 数据每日更新。

相关项目