Rekindle

セッションごとにプロジェクトのコンテキストを説明し直す時間を失っているClaude Codeユーザー向け。

npx rekindle init

AIはセッション間で全てを忘れてしまいます。Rekindleはそれを解決します。

Rekindleは、単なるストレージではなく**セッションの方向付け（オリエンテーション）**を解決するMCP継続性エンジンです。セッション開始時に方向付けを行い、終了時にキャプチャします。すべてローカル、すべてSQLite、APIキーは不要です。

v0.2.0 — オリエンテーションドメイン層、end_sessionツール、型付き継続性レコード。リリースノート

クイックスタート

npx rekindle initを実行すると、プロジェクト内にSQLiteデータベース、アイデンティティテンプレート、トランスクリプトディレクトリを含む.rekindle/が作成されます。コピー用の2つのブロックが表示されます：

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点満点の加算式チェックリスト

• 構造化されたギャップ — 8つのギャップコードを持つ{ code, severity, message }

• 64の自動テスト — ユニット、統合、パフォーマンス

ソースからインストール

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

Claude Code用の2つのオプションのPythonフック（標準ライブラリのみ、外部依存関係ゼロ）：

extract-session.py (Stopフック): セッション終了時にセッションJSONLからMarkdownトランスクリプトを抽出します。

pre-compact-capture.py (PreCompactフック): コンテキスト圧縮の前に最後の80メッセージを保存します。

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

• すべてのデータはローカルです。 外部サーバーには何も送信されません。

• ネットワーク呼び出しはありません。 MCPサーバーはstdio経由で通信します。HTTP、テレメトリ、分析機能はありません。

• トランスクリプトには会話テキストが含まれます。 セッションに秘密情報や資格情報が含まれる場合は、トランスクリプトキャプチャを有効にしないでください。

• トランスクリプトキャプチャはオプションです。 フックはデフォルトではインストールされません。

• SQLiteデータベースは通常のファイルです。 暗号化されていません。必要に応じてOSレベルのディスク暗号化を使用してください。

• .rekindle/はgitignoredです。 initコマンドがこれを自動的に処理します。

• 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ツール）、およびパフォーマンス（1000メモリの検索が100ms以下）。

ロードマップ

v0.3: "It thinks in networks" — 拡散活性化、埋め込みによるセマンティック検索、ブートレポート内のオープンループ、ギャップ分析ツール、評価ハーネス。

ライセンス

MIT