thedotmack/claude-mem

Claude‑Mem – Claude Code のための永続メモリ

概要 – Claude‑Mem は、Claude Code 開発環境（「Claude Code」IDE）に永続的で検索可能なメモリを追加する TypeScript/Node + Bun プラグインです。ツール使用の観察を記録し、セマンティックサマリーを作成し、ローカルの SQLite + Chroma ベクターストアに保存します。新しい Claude Code セッションを開始すると、保存されたメモリが自動的に注入され、アシスタントが完全なプロジェクトコンテキストで会話を継続できます。

仕組み

1. ライフサイクルフック – Claude Code イベント（セッション開始、プロンプト送信、ツール使用など）用に、シェルフリーの小さなコマンド（claude‑mem hook claude‑code <event>）がインストールされます。
2. オブザーバー/ワーカーサービス – ローカル HTTP サービス（Bun で実行）が観察を SQLite DB に書き込み、Chroma を介してベクター埋め込みを構築し、Web UI と API を公開します。
3. ハイブリッド検索 – 全文 + ベクター検索により、自然言語で過去の観察をクエリできます（mem‑search スキル）。MCP ツール（search、timeline、get_observations）は、トークン効率の高い 3 ステップの検索ワークフローを実装します。
4. クラウド同期（オプション） – メモリはホスト型の cmem.ai サービスに同期して、デバイス間でアクセスできます。

主な機能

• セッション間の永続メモリ。Claude Code に自動注入されます。
• プログレッシブ開示：トークンを節約する 3 ステップ検索（インデックス → タイムライン → 完全な詳細）。
• リアルタイムのメモリストリームと引用 ID のための Web ビューア UI。
• プライバシータグ（<private>）で機密コンテンツを除外。
• ~/.claude‑mem/settings.json で設定可能（モデル、ポート、コンテキスト注入、言語モードなど）。
• 複数の IDE/プラグインで動作：Grok Bot、OpenCode、T3 Code、Antigravity CLI、OMP、Pi、DeepSeek Harness、OpenClaw ゲートウェイ。

はじめに

# インストールとセットアップ（オプションのクラウドメモリ用サインインを含む）
npx claude‑mem install

または、特定の IDE 用にインストールします（例：npx claude‑mem install --ide opencode）。インストーラーはフックランチャーを PATH に追加し、ワーカーサービスを起動します。

典型的なワークフロー

1. Claude Code でコーディングします。プラグインがツール呼び出しと観察を記録します。
2. 後で、Claude に何かを思い出してもらいます：
   • mem‑search スキルまたは MCP search ツールを使用して、関連 ID のコンパクトなリストを取得します。
   • timeline で絞り込み、周囲のコンテキストを確認します。
   • get_observations で完全な詳細を取得します。
3. Claude は取得したメモリを会話に注入し、継続性を維持します。

対象ユーザー – Claude Code（または互換 IDE）を使用し、過去のデバッグセッション、設計上の決定、セキュリティアラートに関する知識を、手動で再入力することなく AI アシスタントに保持させたい開発者。

ライセンス – Apache 2.0（コア）、ragtime/ サブディレクトリも Apache 2.0。

リソース – 完全なドキュメントは https://docs.claude‑mem.ai、サポートは GitHub issues、Discord コミュニティ、更新情報は X アカウント。