AIコーディング助手の「記憶喪失」を解決!セッションを超えて文脈を保持する永続メモリシステム — claude-mem

thedotmack/claude-memTypeScript43.2k

claude-memは、AIコーディング助手「Claude Code」のプラグインで、作業セッション中にClaudeが行ったすべての操作や発見を自動的に記録・圧縮し、次回のセッションに関連する文脈を自動注入してくれるツールです。たとえば、昨日のコーディング作業でClaudeが見つけたバグの情報や、行った修正内容を、今日の作業開始時に自動的に思い出してくれる「メモ帳」のような仕組みです。プログラマーが毎回同じ説明をClaudeに繰り返す必要がなくなり、まるで長期記憶を持つ助手と一緒に仕事をしている感覚で開発を進められます。自然言語(普段の言葉)で過去の作業履歴を検索できる機能や、Webブラウザで記憶の流れをリアルタイム確認できるビューアーも備えています。

🔥 なぜ話題?

Claude CodeなどAIコーディング助手の利用が急速に広がる中で、『セッションが切れると文脈がリセットされてしまう』という共通の課題を解決するプラグインとして注目を集めています。特にClaude Codeの公式プラグインマーケットプレイスからワンコマンドで導入できる手軽さと、トークン(AIが処理するテキストの単位)消費を約10分の1に抑える効率的な検索設計が、開発者コミュニティで話題になっています。

💡 こう使える!

例えば、先週Webアプリのログイン機能のバグをClaudeと一緒に調査・修正したとします。今週新たにClaude Codeのセッションを開いて『先週のログインバグの修正内容を踏まえて、同じ認証モジュールに新機能を追加して』と頼むと、claude-memが先週の調査内容・修正箇所・判断理由をClaudeに自動で伝えてくれるため、ゼロから説明し直す必要がありません。

ユースケース: Claude Codeを使ったソフトウェア開発で、過去のセッションの作業内容や知見を自動的に次のセッションに引き継ぎ、AIアシスタントに「長期記憶」を持たせたい場面で使える。

  • セッション間の文脈を自動で記録・圧縮・注入する永続メモリ機能
  • 自然言語で過去の作業履歴を検索でき、トークン消費を約10分の1に抑える3層検索設計
  • Webビューアー・プライバシータグ・ベータ機能(Endless Mode)など充実した周辺機能
GitHubで見る →

A Claude Code plugin that automatically captures everything Claude does during your coding sessions, compresses it with AI (using Claude's agent-sdk), and injects relevant context back into future sessions.

技術情報

言語

TypeScript

ライセンス

NOASSERTION

最終更新

2026-03-30

スター数

43,178

フォーク数

3,206

Issue数

188

トピック

aiai-agentsai-memoryanthropicartificial-intelligencechromadbclaudeclaude-agent-sdkclaude-agentsclaude-codeclaude-code-pluginclaude-skillsembeddingslong-term-memorymem0memory-engineopenmemoryragsqlitesupermemory

技術詳細

アーキテクチャ・仕組み

claude-memは以下のコアコンポーネントで構成されています:

  • 5つのライフサイクルフック: SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd の各タイミングで自動的に処理を実行(合計6つのフックスクリプト)
  • スマートインストーラー: キャッシュされた依存関係チェッカー(プリフックスクリプト)
  • ワーカーサービス: ポート37777でHTTP APIを提供し、Webビューアー UIと10個の検索エンドポイントを持つ。Bunランタイムで管理
  • SQLiteデータベース: セッション、観察(observation)、要約を永続保存
  • Chroma ベクトルデータベース: セマンティック検索(意味に基づく検索)とキーワード検索を組み合わせたハイブリッド検索

MCP検索ツール(4つのツール)

トークン効率の良い 3層ワークフロー を採用:

  1. search - コンパクトなインデックスを取得(結果1件あたり約50〜100トークン)
  2. timeline - 特定の観察周辺の時系列コンテキストを取得
  3. get_observations - フィルタ後のIDのみ詳細を取得(結果1件あたり約500〜1,000トークン)

この設計により、詳細取得前にフィルタリングすることで 約10倍のトークン節約 を実現。

対応環境・システム要件

  • Node.js: 18.0.0以上
  • Claude Code: プラグインサポート付きの最新版
  • Bun: JavaScriptランタイム(未インストールの場合は自動インストール)
  • uv: ベクトル検索用Pythonパッケージマネージャー(未インストールの場合は自動インストール)
  • SQLite 3: 永続ストレージ用(バンドル済み)
  • Windows: Node.jsとnpmがPATHに追加されている必要あり

主要な機能一覧

  • 永続メモリ: セッション間でコンテキストが保持される
  • プログレッシブディスクロージャー: 段階的なメモリ取得でトークンコストを可視化
  • スキルベース検索: 自然言語でプロジェクト履歴をクエリ(mem-searchスキル)
  • Webビューアー UI: http://localhost:37777 でリアルタイムのメモリストリームを表示
  • Claude Desktopスキル: Claude Desktopの会話からもメモリ検索が可能
  • プライバシーコントロール: <private> タグで機密情報のストレージ除外が可能
  • コンテキスト設定: 注入するコンテキストのきめ細かい制御
  • 引用機能: 過去の観察をIDで参照(APIエンドポイント: /api/observation/{id}
  • ベータチャンネル: Endless Mode(バイオミメティック・メモリアーキテクチャ)などの実験的機能

設定オプション

設定ファイルは ~/.claude-mem/settings.json に自動生成され、以下を制御可能:

  • AIモデルの選択
  • ワーカーポート番号
  • データディレクトリ
  • ログレベル
  • コンテキスト注入設定

外部連携

  • OpenClaw Gateway: ワンコマンドでOpenClawゲートウェイに統合可能。Telegram、Discord、Slackなどへのリアルタイム通知にも対応
  • Claude Agent SDK: AI圧縮処理にClaude Agent SDKを使用

ライセンス・商用利用

  • メインプロジェクト: AGPL-3.0(ネットワークサーバーでの修正版デプロイ時はソースコード公開が必要。派生物も同ライセンス)
  • ragtime/ ディレクトリ: PolyForm Noncommercial License 1.0.0(非商用のみ)

技術スタック

  • TypeScriptで構築
  • Claude Agent SDKを活用
  • Claude Codeのプラグインシステムに統合

インストール・クイックスタート

Claude Codeのターミナルで以下の2コマンドを実行するだけでインストールできます:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

インストール後、Claude Codeを再起動すれば、過去のセッションの文脈が自動的に新しいセッションに反映されます。

注意: npm install -g claude-mem ではプラグインとして正しく動作しません。必ず上記の /plugin コマンドからインストールしてください。

OpenClaw Gateway向けインストール

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

参考になる外部の関連記事

過去のトレンド履歴

関連リポジトリ

使うほど賢くなるAIエージェント — 学習ループ内蔵でどこからでも話しかけられる — hermes-agent

NousResearch/hermes-agentPython48.5k

Hermes Agentは、Nous Research社が開発した「自分で成長するAIエージェント」です。普通のAIチャットと違い、過去の会話を記憶し、複雑なタスクをこなした後に自動で「スキル」を作成

自分のPCで動くプライバシー重視のAI検索エンジン — Perplexica

ItzCrazyKns/PerplexicaTypeScript31.1k

Perplexicaは、インターネット上の情報をAIが読み取り、出典付きで正確な回答を返してくれるプライバシー重視の検索エンジンです。Googleのように検索するだけでなく、AIが内容を要約して「答え

Claude Codeを「チーム」に進化させる!複数AIエージェント同時稼働のマルチエージェント司令塔 — oh-my-claudecode

Yeachan-Heo/oh-my-claudecodeTypeScript20.1k

oh-my-claudecodeは、Claude Code(AIコーディングアシスタント)を複数のAIエージェントが協力して動く「チーム」に変えるツールです。通常Claude Codeは1つのAIが1

AIコーディングエージェントにバックエンドを丸投げ!認証・DB・ストレージを一括管理 — InsForge

InsForge/InsForgeTypeScript4.7k

InsForgeは、AIコーディングエージェント(CursorなどのAI搭載コードエディタ)がバックエンド(サーバー側の仕組み)を自動で構築・操作できるようにするプラットフォームです。データベース、ユ

AIコーディングアシスタントを最強にチューニング!28エージェント×119スキルの包括的パフォーマンス最適化システム — everything-claude-code

affaan-m/everything-claude-codeJavaScript103.3k

everything-claude-codeは、Claude CodeやCodex、Cursorなどの「AIコーディングアシスタント」の性能を最大限に引き出すための総合チューニングシステムです。28種