AIコーディングエージェント向けのローカルファーストな永続メモリ。決定事項や学びをSQLiteに保存し、MCP経由でClaude Code、Cursorなどのクライアントに提供します。
ramakay/claude-self-reflect
過去の会話をセマンティック検索できる、MCPサーバーとして動作するClaude Code向けローカルRustツールです。
- スター
- 230
- フォーク
- 29
- 未解決の Issue
- 11
- 最終コミット
- 5 日前
これは何?
Claude Self-Reflectは、Claude Code向けのメモリレイヤーです。~/.claude/projectsにある過去の会話トランスクリプトをインデックス化して検索可能にすることで、以前のセッションで得た解決策、設計上の判断、デバッグ履歴を必要なときに呼び出せます。単一のRustバイナリとして提供され、チャンク、埋め込み、エンリッチメントの状態をSQLiteに保存し、ローカルのFastEmbed埋め込みとHNSWインデックスを使ってベクトル検索を行います。基本的な検索にデータベースサーバー、コンテナ、APIキーは必要ありません。
このツールはClaude CodeにMCPサーバーを登録し、6つのライフサイクルフック(SessionStart、UserPromptSubmit、PostToolUse、Stop、PreCompact、SessionEnd)をインストールして、関連する過去のコンテキストを自動で挿入します。ファイル検索、概念検索、タイムラインや最近の作業の表示、会話全体の取得、関数やファイルと、それらに影響を与えた会話を結び付けるコードグラフなど、明示的な検索に使える15個のMCPツールを提供します。インストール方法はシェルスクリプトまたはnpmです。フックの有効化と会話のインポートは、明示的なセットアップを行った後にのみ実行されます。
オプションのAIナラティブ機能では、Claude CLIを実行して会話を検索可能なブリーフィングに要約できます。この機能は環境変数で無効化できます。
主な機能
- 01ローカル埋め込みを使って過去のClaude Codeの会話をセマンティック検索
- 02SQLiteストレージとHNSWベクトルインデックスを備えた単一のRustバイナリで、外部サービスは不要
- 03関連する過去のコンテキストを自動挿入する6つのライフサイクルフック
- 04ファイル、概念、タイムライン、会話を検索できる15個のMCPツール
- 05関数やファイルと、それらに影響を与えた会話を結び付けるコードグラフ
- 06有効化するまでMCP登録やフックのインストールを行わない、同意に基づくセットアップ
ユースケース
- 以前のClaude Codeセッションでバグをどう修正したか、コンポーネントをどう設計したかを確認する
- 特定のファイルや関数の現在のコードに至った経緯を、関連する会話から探す
- 長期にわたるプロジェクトの判断を、複数のセッションをまたいで参照できるようにする
クイックスタート
- 1
READMEに記載されている公式インストールスクリプトを実行します(バイナリをダウンロードし、有効化の前に確認を求めます)
- 2
npmでインストールします(バイナリのみをダウンロードし、有効化はしません)
npm install -g claude-self-reflect - 3
セットアップを有効化します(MCPサーバーを登録し、フックをインストールし、会話をインポートします)
csr-engine setup - 4
Claude Codeを再起動します
使う前に知っておきたいこと
- ビルド済みバイナリはmacOS Apple Silicon、Linux x86_64/WSL、Linux ARM64に対応しています。Intel Macではソースからのビルドが必要です。
- AIによるナラティブは任意ですが、claude -p経由でClaudeのサブスクリプションを使用するため、トークンを消費します。
収録されている特集
トピック
よくある質問
- claude-self-reflect とは?
- 過去の会話をセマンティック検索できる、MCPサーバーとして動作するClaude Code向けローカルRustツールです。 Claude Self-Reflectは、Claude Code向けのメモリレイヤーです。~/.claude/projectsにある過去の会話トランスクリプトをインデックス化して検索可能にすることで、以前のセッションで得た解決策、設計上の判断、デバッグ履歴を必要なときに呼び出せます。単一のRustバイナリとして提供され、チャンク、埋め込み、エンリッチメントの状態をSQLiteに保存し、ローカルのFastEmbed埋め込みとHNSWインデックスを使ってベクトル検索を行います。基本的な検索にデータベースサーバー、コンテナ、APIキーは必要ありません。
- claude-self-reflect は無料で使えますか?ライセンスは?
- claude-self-reflect は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- claude-self-reflect は今もメンテナンスされていますか?
- 活発にメンテナンス中。claude-self-reflect の最終コミットは 2026年11月2日 です。
- claude-self-reflect は何に使えますか?
- 以前のClaude Codeセッションでバグをどう修正したか、コンポーネントをどう設計したかを確認する 特定のファイルや関数の現在のコードに至った経緯を、関連する会話から探す 長期にわたるプロジェクトの判断を、複数のセッションをまたいで参照できるようにする
- claude-self-reflect のインストール方法は?
- READMEに記載されている公式インストールスクリプトを実行します(バイナリをダウンロードし、有効化の前に確認を求めます) npmでインストールします(バイナリのみをダウンロードし、有効化はしません): npm install -g claude-self-reflect セットアップを有効化します(MCPサーバーを登録し、フックをインストールし、会話をインポートします): csr-engine setup Claude Codeを再起動します
- claude-self-reflect はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/ramakay/claude-self-reflect
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
AIエージェント向けのローカルファーストな永続メモリ。ナレッジグラフ、検索機能、MCP serverを備え、Markdownファイルに保存します。
誰の記憶か、情報源、いつ有効だったか、誰が読めるかを記録する、AI向けローカルメモリストア。
Claude Code、Cursor、CodexなどのAIコーディングエージェント向けに、ディスク上のSQLiteファイルをMCP経由で提供するローカル優先の永続メモリ。
コーディングエージェント向けの永続メモリ。セッション中の活動を記録してAIで圧縮し、後続セッションに関連するコンテキストを引き継ぎます。
コーディングエージェント向けの長期記憶。ローカルのSQLiteデータベースに記憶を保存し、Claude Code、Codex、CursorなどのMCPクライアント間で共有できます。