gh

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

thedotmack/claude-memTypeScript56.7k

claude-memは、AIコーディングツール「Claude Code」のプラグインで、コーディングセッション中にClaudeが行ったすべての操作を自動的に記録し、AIで圧縮・要約した上で、次回のセッションに関連する文脈を自動で注入してくれるツールです。たとえるなら、優秀な秘書が前回の会議の議事録を次の会議前に要点だけまとめて渡してくれるようなイメージです。claude-memを使うことで、セッションが終了したり接続が切れたりしても、プロジェクトの知識が途切れることなく継続されます。プログラマーやAIを使って開発する人が、毎回同じ説明を繰り返す手間を省き、効率的に作業を続けられるようになります。Gemini CLIやOpenCodeなど他のAIツールにも対応しています。

🔥 なぜ話題？

Claude CodeやGemini CLIなどAIコーディングアシスタントの利用が急速に広がる中、「セッションをまたぐと文脈がリセットされる」という多くのユーザーが感じていた痛点を解決するツールとして注目を集めています。特にワンコマンドでインストールでき、自動で動作する手軽さが話題です。

💡 こう使える！

例えば、昨日のセッションで認証機能のバグを修正していて、今日新しいセッションを開始したとき、claude-memが昨日の修正内容や発見した問題点を自動的にClaudeに伝えてくれるので、『昨日どこまでやったっけ？』と一から説明し直す必要がなく、すぐに続きの作業に取りかかれます。

ユースケース: AIコーディングツールを日常的に使う開発者が、セッション間でプロジェクトの文脈を自動的に引き継ぎ、作業効率を大幅に向上させるために使います。

  • セッション終了後もAIの記憶が自動で保存・復元される持続的メモリシステム
  • トークン消費を約10分の1に抑える3層構造の賢い検索システム
  • Claude Code・Gemini CLI・OpenCodeなど複数のAIツールに対応
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-04-15

スター数

56,721

フォーク数

4,572

Issue数

228

トピック

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を提供。Bunランタイムで管理され、Webビューア（http://localhost:37777）で記憶ストリームをリアルタイム確認可能
  • SQLiteデータベース: セッション、観察記録、要約を永続的に保存
  • Chroma ベクトルデータベース: セマンティック検索＋キーワード検索のハイブリッド検索で、知的な文脈取得を実現

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

トークン効率を最大化する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: バンドル済み
  • 対応IDE/ツール: Claude Code、Gemini CLI、OpenCode、OpenClaw
  • Windows: Node.jsとnpmがPATHに設定されている必要あり

主要な機能一覧

  • 🧠 持続的メモリ: セッションをまたいで文脈を保持
  • 📊 段階的開示（Progressive Disclosure）: トークンコスト表示付きの階層的メモリ取得
  • 🔍 スキルベース検索: 自然言語でプロジェクト履歴を検索（mem-searchスキル）
  • 🖥️ Webビューア: http://localhost:37777 でリアルタイム記憶ストリームを閲覧
  • 💻 Claude Desktopスキル: Claude Desktopの会話からメモリを検索
  • 🔒 プライバシー制御: <private>タグで機密情報をストレージから除外
  • ⚙️ 文脈設定: 注入する文脈の細かな制御が可能
  • 🔗 引用機能: 過去の観察をIDで参照
  • 🧪 ベータチャンネル: Endless Mode（長時間セッション用の生体模倣メモリアーキテクチャ）などの実験的機能

設定オプション

設定ファイルは ~/.claude-mem/settings.json に自動生成される。AIモデル、ワーカーポート、データディレクトリ、ログレベル、文脈注入設定などをカスタマイズ可能。

モード・言語設定

CLAUDE_MEM_MODE で動作モードと言語を制御：

モード説明
codeデフォルト（英語）
code--zh簡体字中国語
code--ja日本語

code--[lang] パターンでISO 639-1言語コードを指定。

ライセンス

  • メイン: AGPL-3.0（改変してネットワークサーバーにデプロイする場合はソースコード公開が必要）
  • ragtime/ ディレクトリ: PolyForm Noncommercial License 1.0.0（非商用のみ）

技術スタック

  • TypeScriptで構築
  • Claude Agent SDKを使用
  • Bunランタイムでワーカーサービスを管理
  • SQLite + FTS5（全文検索）
  • Chromaベクトルデータベースによるハイブリッド検索

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

インストール手順

Claude Code向けにインストール（1コマンド）:

npx claude-mem install

Gemini CLI向けにインストール:

npx claude-mem install --ide gemini-cli

OpenCode向けにインストール:

npx claude-mem install --ide opencode

またはClaude Code内のプラグインマーケットプレイスからインストール:

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

インストール後、Claude CodeまたはGemini CLIを再起動すると、前回セッションの文脈が自動的に新しいセッションに反映されます。

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

QClaude Codeに「前回の続きから」が通じるようになった話 ― claude-memを高校生でもわかるように解説QClaude Codeに永続メモリを追加する「claude-mem」を実際に導入してみた — 自作hook版との比較QClaude Codeに「ふりかえり」を教えてみたら、セッションをまたいで成長するAIパートナーに近づいた話ZClaude Code に永続記憶を持たせる OSS「claude-memory-sync」を作った — 設計と落とし穴Z過去の session をほしい時に参照する方針で claude-mem のトークン消費を激減させた話ZClaude Codeのトークン枯渇問題をClaude-Memで解決した話

過去のトレンド履歴

AIコーディング助手の「記憶喪失」を解消！セッションをまたいで文脈を引き継ぐ永続メモリシステム — claude-mem

2026-04-14

3+3.2k

AIコーディングの記憶喪失を解消！セッションをまたいで文脈を自動保存・復元する魔法のプラグイン — claude-mem

2026-04-13

7+753

AIコーディング助手の「記憶」を永続化！セッションをまたいで文脈を自動引き継ぎ — claude-mem

2026-03-30

10+373

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

2026-03-17

7+1.0k

関連リポジトリ

使うほど賢くなるAIエージェント — 学習・記憶・自動化を全部入りで月5ドルから運用 — hermes-agent

NousResearch/hermes-agentPython87.5k

Hermes Agentは、Nous Research社が開発した「自己改善する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同僚 — あなたの仕事をローカルで支える — rowboat

rowboatlabs/rowboatTypeScript11.9k

Rowboatは、メールや会議メモなどの仕事の情報を自動的に「知識グラフ（情報同士のつながりを地図のように整理したもの）」として蓄積し、その文脈を活かして仕事を手伝ってくれるAIアシスタントです。たと

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

InsForge/InsForgeTypeScript4.7k

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