Rekindle

专为那些每次会话都要重新解释项目背景而浪费时间的 Claude Code 用户设计。

npx rekindle init

您的 AI 会在会话之间遗忘所有内容。Rekindle 可以解决这个问题。

Rekindle 是一个 MCP 连续性引擎，它解决的不仅仅是存储问题，而是**会话导向（session orientation）**问题。在会话开始时进行导向，在会话结束时进行捕获。全部本地化，全部基于 SQLite，零 API 密钥。

v0.2.0 — 导向领域层，end_session 工具，类型化连续性记录。发布说明

快速开始

运行 npx rekindle init 会在您的项目中创建一个 .rekindle/ 目录，其中包含 SQLite 数据库、身份模板和转录目录。它会打印出两个需要复制的代码块：

1. MCP 配置 — 粘贴到 ~/.claude.json 中（告诉 Claude Code 服务器在哪里）

2. 启动说明 — 粘贴到您项目的 CLAUDE.md 中（告诉 AI 如何进行导向）

然后填写 .rekindle/identity.md 并开始一个新的 Claude Code 会话。

会话 1 进行存储。会话 2 进行记忆。会话 10 进行预判。

问题所在（43 个会话的数据）

在 43 个会话中，我们测量了 AI 助手在会话开始时未能加载的内容：

现有的记忆工具（Mem0, Letta, Zep）优化的是检索准确性：AI 能否找到它存储的内容？这是必要的，但还不够。它们都没有解决 AI 是否为本次会话加载了正确的上下文，或者它是否能检测到它遗漏了什么。

Rekindle 解决了会话导向问题：在助手开始工作之前，加载身份、近期上下文、记忆健康状况以及缺失上下文的警告。

查看 docs/gap-analysis.md 获取完整的研究数据集。

它能做什么

启动：在会话开始时进行导向

boot_report 在任何工作开始前运行导向流水线：

boot_report
  +-- Read identity document (who am I working with?)
  +-- Scan memory stats (what do I know?)
  +-- Find latest checkpoint (where did we leave off?)
  +-- Read last transcript (what actually happened?)
  +-- Detect gaps (what am I missing?)
  +-- Calculate orientation score (how oriented am I?)
  --> "Carrying forward: [context loaded, gaps identified, score: 80/100]"

健康输出：

## Orientation Score
100/100

+20  Identity document loaded
+20  Recent checkpoint exists
+20  Session transcript found
+20  Recent memories exist (last 7 days)
+10  Relationship/preference memories populated
+10  Project-scoped memories found

稀疏输出（标记缺失内容）：

## Gaps Detected
- [critical] identity_missing: No identity document found
- [warning] checkpoint_missing: No recent checkpoint

## Orientation Score
20/100

 ✗  Identity document loaded (20pts)
 ✗  Recent checkpoint exists (20pts)
 ✗  Session transcript found (20pts)
+20  Recent memories exist (last 7 days)
 ✗  Relationship/preference memories populated (10pts)
 ✗  Project-scoped memories found (10pts)

捕获：在会话结束时闭环

end_session 存储结构化的连续性记录 — 而不仅仅是摘要：

所有记录都带有 type、source 和 session_id 元数据。下一次 boot_report 会自动加载检查点。

会话之间：搜索与管理

类别： preference lesson context relationship general

为什么不仅仅使用 CLAUDE.md？

静态文件是被动的。您的 AI 可以读取它，但无法搜索、排名、跟踪已检索的内容，也无法告诉您缺少了什么。Rekindle 增加了：

• 搜索 — 带有重要性加权排名的全文搜索

• 结构 — 跨记忆的类别和项目范围划分

• 导向 — 启动时主动加载上下文，而非仅按需检索

• 缺口检测 — 标记缺失的身份、空类别、陈旧数据

• 评分 — 透明的检查清单，让您知道 AI 的导向程度如何

• 会话捕获 — 包含检查点、决策和开放循环的结构化关闭

v0.2.0 亮点

• 7 个 MCP 工具 — 增加了用于结构化会话关闭的 end_session

• 导向领域层 — boot_report 现在是一个轻量级包装器；所有逻辑都在 OrientationService、GapDetector、Scorer 中

• 类型化连续性记录 — 记忆携带 type、source、session_id，而不是内容前缀

• 导向评分 — 跨 6 个标准的 100 分累加检查清单

• 结构化缺口 — { code, severity, message }，包含 8 个缺口代码

• 64 个自动化测试 — 单元测试、集成测试和性能测试

从源码安装

git clone https://github.com/Skitchy/rekindle.git
cd rekindle
npm install
npm run build
node dist/init/cli.js init

两个用于 Claude Code 的可选 Python 钩子（仅标准库，零外部依赖）：

extract-session.py (停止钩子)：当会话结束时，从会话 JSONL 中提取 Markdown 转录。

pre-compact-capture.py (预压缩钩子)：在上下文压缩前保存最后 80 条消息。

{
  "hooks": {
    "Stop": [{
      "type": "command",
      "command": "python3 /path/to/rekindle/hooks/extract-session.py"
    }]
  }
}

• 所有数据均为本地存储。 不会发送到外部服务器。

• 无网络调用。 MCP 服务器通过 stdio 通信。无 HTTP，无遥测，无分析。

• 转录包含对话文本。 如果您的会话包含机密或凭据，请勿启用转录捕获。

• 转录捕获是可选的。 默认不安装钩子。

• SQLite 数据库是普通文件。 未加密。如有需要，请使用操作系统级磁盘加密。

• .rekindle/ 已被 gitignore。 初始化命令会自动处理此项。

• boot_report 读取本地文件。 路径未沙盒化。仅与您信任的 MCP 客户端和提示词一起使用。

rekindle/
  src/
    index.ts          MCP server entry point
    server.ts         Server setup, tool registration
    storage/
      sqlite.ts       SQLite + FTS5, schema migration, sessions
    orientation/
      types.ts        OrientationResult, Gap, ScoreItem
      GapDetector.ts  Structural gap detection (8 codes)
      Scorer.ts       Orientation scoring (6 criteria, 100pts)
      OrientationService.ts   Orchestrator
      OrientationRenderer.ts  Markdown + JSON output
    tools/
      boot-report.ts  Thin wrapper over OrientationService
      end-session.ts  Structured session close
      store.ts search.ts list.ts delete.ts update.ts
    init/
      cli.ts scaffold.ts templates/
  hooks/
    extract-session.py
    pre-compact-capture.py

存储： 通过 better-sqlite3 使用 SQLite + FTS5。BM25 排名由重要性加权。带有 type、source、session_id 的类型化记录。

传输： stdio（标准 MCP）。开箱即用支持 Claude Code。

测试

npm test

64 个测试：存储 CRUD + FTS5 排名，导向领域（缺口检测、评分、服务、渲染），MCP 集成（所有 7 个工具），以及性能（100ms 内完成 1000 条记忆搜索）。

路线图

v0.3: "网络化思维" — 扩散激活、通过嵌入进行语义搜索、启动报告中的开放循环、缺口分析工具、评估工具集。

许可证

MIT