ライブラリ / SDK
thedotmack/claude-mem avatar
thedotmack/claude-mem

Claude-Memは、エージェントの観察を次のセッションへ戻す永続メモリ

すべてのエージェントのセッション全体で永続的なコンテキスト。セッション中にエージェントが行うすべての情報をキャプチャし、AI で圧縮して、関連するコンテキストを将来のセッションに注入します。 Claude Code、OpenClaw、Codex、Gemini、Hermes、Copilot、OpenCode などで動作します。

スター 93,960フォーク 8,276JavaScriptApache-2.0

ひと目でわかる

これは何?
セッション中の操作を記録し、AIで圧縮し、関連する文脈を後続セッションへ注入するメモリ層です。
誰に向いている?
Claude-Memは、Claude Codeなどのエージェント作業をセッションをまたいで参照したい開発者に向きます。観察内容を保存する設計なので、リポジトリ情報や秘密情報をどこへ置くかを確認できない組織には慎重さが必要です。
商用利用できる?
できます。Apache-2.0 は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
今もメンテナンスされている?
されています。最後のコミットは 2 日前です。
何の言語で書かれている?
主に JavaScript です(GitHub の言語統計による)。

回答はプロジェクトの GitHub データ(最終同期:2026年9月15日)と当サイトの分析に基づくもので、法的助言ではありません。

オープンソース詳細解説

Claude Code 向けの永続メモリ圧縮システム

README は冒頭で Claude-Mem を、Claude Code 向けに構築された永続メモリ圧縮システムとして説明しています。セッション中にエージェントが行ったすべての操作を記録し、AI で圧縮して、関連するコンテキストを将来のセッションに注入します。目標は、セッションが終了または再接続した後も、Claude がプロジェクトに関する知識の連続性を維持できるようにすることです。GitHub の説明では互換性リストが OpenClaw、Codex、Gemini、Hermes、Copilot、OpenCode にまで拡張されていますが、README でインストール手順が示されているのは Claude Code、OpenCode、Antigravity CLI、OpenClaw ゲートウェイのみで、他のツールの手順はドキュメントサイトで確認する必要があります。

インストール方法と npm に関する注意

ドキュメントに記載されたクイックスタートは単一のコマンド `npx claude-mem install` です。OpenCode 向けには `npx claude-mem install --ide opencode`、Antigravity CLI 向けには `npx claude-mem install --ide antigravity` という変種があります。Claude Code ユーザーは `/plugin marketplace add thedotmack/claude-mem` でプラグインマーケットプレイスを追加し、`/plugin install claude-mem` を実行してから Claude Code を再起動する方法も使えます。README は、`npm install -g claude-mem` は SDK/ライブラリのみをインストールし、プラグインフックの登録やワーカーサービスのセットアップは行わないと警告しています。OpenClaw ゲートウェイでは別のインストーラ `curl -fsSL https://install.cmem.ai/openclaw.sh | bash` を使用し、README によると依存関係、プラグイン設定、AI プロバイダ構成、ワーカー起動、任意のリアルタイム観察フィードを処理します。

5 つのフックスクリプト、ワーカー、ストレージ

README は 5 つのライフサイクルフック(SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd)を説明しており、合計で 6 つのフックスクリプトになることと、キャッシュされた依存関係をチェックするスマートインストール用のプレフックがあることを述べています。Bun が管理するローカルワーカーサービスは、Web ビューア UI と検索エンドポイントを備えた HTTP API を公開します。ストレージには、セッション、観察結果、要約を保存する SQLite と、ハイブリッドな意味検索とキーワード検索のための Chroma ベクトルデータベースを使用します。README は自然言語クエリ用の mem-search スキルを挙げており、プロジェクトはこれをトークンコストの可視性を備えた階層的なメモリ検索として説明しています。また、機密コンテンツをストレージから除外する `<private>` タグにも言及しています。

MCP 検索ツールと 3 層ワークフロー

Claude-Mem には 4 つの MCP ツールが含まれ、トークン効率の良い 3 層パターンに従います。`search` ツールは ID 付きのコンパクトなインデックスを返し、結果あたり約 50〜100 トークンです。`timeline` は関連する結果の周辺の時系列コンテキストを提供します。`get_observations` はフィルタリングされた ID の完全な詳細のみを取得し、結果あたり約 500〜1,000 トークンと推定されています。README は、詳細を取得する前にフィルタリングすることで約 10 倍のトークン節約になると主張しています。README の例では authentication bug の検索を行い、選択した ID の観察結果をバッチ取得しています。これらの数値は README の推定値であり、ベンチマーク手法は示されていません。

設定、モード、システム要件

設定は `~/.claude-mem/settings.json` に保存され、初回実行時にデフォルト値で自動生成されます。AI モデル、ワーカーポート、データディレクトリ、ログレベル、コンテキスト注入をカバーしています。`CLAUDE_MEM_MODE` 設定は、ワークフローの動作(code、chill、investigation)と生成される観察結果の言語の両方を制御します。README には `code` がデフォルトの英語モード、`code--zh` が簡体字中国語モード、`code--ja` が日本語モードとして記載され、他の言語は `code--[lang]` パターンに従い、`code--zh` は追加インストール不要で組み込まれていると注記されています。システム要件として、Node.js 20.0.0 以上、プラグイン対応の最新 Claude Code、Bun(不足時は自動インストール)、ベクトル検索用の uv(不足時は自動インストール)、バンドルされた SQLite 3 が挙げられています。

ブランチ、開発、ライセンス

安定版は `main` ブランチからリリースされ npm に公開されます。`core-dev` と `community-edge` はソースから実行されるブランチで、初期の信頼性修正とコミュニティ統合を目的としています。README はコントリビュータに対して、リポジトリをフォークし、機能ブランチを作成し、テストを伴う変更を行い、ドキュメントを更新し、プルリクエストを提出するよう指示しており、詳細は開発ガイドへのリンクで案内されています。このプロジェクトは Apache-2.0 ライセンスで提供され、README は `ragtime/` ディレクトリも同じライセンスであると述べています。ライセンス文書は、複製、派生作品の作成、公開表示、公開上演、再ライセンス、配布を行う永続的、世界的、非独占的、無償、ロイヤリティフリー、取消不能な著作権ライセンスを認めています。サポート、セキュリティ保証、保証については何も述べられていません。

CMEM トークンに関する注記

README の末尾には、サードパーティが作成し、プロジェクト作者 Alex Newman が公式に受け入れたトークンである CMEM に関するセクションがあります。README はこのトークンを、成長のためのコミュニティ触媒であり、CMEM を最も必要とする開発者や知識労働者に届けるための手段であると説明しています。公式のベースコントラクトアドレスが記載されていますが、README 自体にはトークンの仕組み、ガバナンス、ユーティリティに関する技術的詳細はありません。リポジトリのメタデータには執筆時点で 89,638 スターと 7,805 フォークとありますが、README は採用指標については言及していません。

編集部の結論

Claude-Memは、Claude Codeなどのエージェント作業をセッションをまたいで参照したい開発者に向きます。観察内容を保存する設計なので、リポジトリ情報や秘密情報をどこへ置くかを確認できない組織には慎重さが必要です。まず5つのフックスクリプト、ワーカー、SQLite、MCPの3層検索をテスト用プロジェクトで動かし、保存対象と削除方法を確認してから本番の設定を決めてください。

公式情報源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
コミュニティノート

コミュニティノート