概要

Claude Code Semantic Memory System は、Claude Code の各セッションから得られる「学び」を抽出し、永続的に保存して将来のプロンプトに自動的に注入するための軽量なシステムです。Claude Code のデフォルトはステートレスであるため、セッションが切り替わったりコンテキストが圧縮されると過去の決定やトラブルシュート情報が忘れられてしまいます。本プロジェクトはそのギャップを埋め、過去に発見したソリューション、注意すべき落とし穴、環境設定や設計方針などを再利用可能にすることで、反復作業や同じ問題の繰り返しを防ぎます。実装はシェルスクリプト中心で、デーモンとして動作するコンポーネントと利用例が含まれます。

リポジトリの統計情報

スター数: 13
フォーク数: 1
ウォッチャー数: 13
コミット数: 26
ファイル数: 8
メインの言語: Shell

主な特徴

過去セッションから「学び」を抽出して永続化し、以降のプロンプトに注入することで忘却を防止する。
デーモン（常駐）プロセスにより、会話ログやセッション出力を監視・処理して自動的にメモリを更新する。
軽量なスクリプト構成で導入が容易、examples ディレクトリに利用例が含まれる。
Claude Code のワークフローにシームレスに組み込めるよう設計されている。

技術的なポイント

本プロジェクトは「抽出（extract）」「格納（store）」「検索／注入（retrieve & inject）」という典型的なセマンティックメモリのワークフローを採用しています。まず、Claude Code のセッション出力やログから重要なフラグメント（解決済みのテクニック、トラブルシュートの手順、設計決定など）をテキストベースで抽出し、メタデータとともに永続ストアへ保存します。保存形式はリポジトリ自体の構造やシェルスクリプトを想定した簡易的なファイルストア／インデックスである可能性が高く、外部ベクトルDBや重厚な依存を必要としない軽量性が特徴です。検索時は現在のプロンプトや会話コンテキストと照合し、関連性の高いメモリを選択してプロンプト先頭または補助コンテキストとして注入します。これにより、Claude Code が新しいセッションでも過去の知見を参照して応答を生成できるようになります。デーモンは定期的またはイベント駆動でログを処理し、手動トリガや自動トリガの両方に対応する設計が想定されます。設計上、プライバシーとストレージの扱いに注意を払うべきで、保存する情報のフィルタリングやアクセス制御が実運用上の鍵となります。

プロジェクトの構成

主要なファイルとディレクトリ：

.gitignore: file — ビルド成果物や一時ファイルの除外ルール。
LICENSE: file — ライセンス表記（利用条件）。
README.md: file — プロジェクトの概要、目的、セットアップ手順や使い方の説明。
daemon: dir — 永続化・監視を行うデーモンプログラムやスクリプトを格納。セッションログの監視、抽出処理、ストア更新のロジックが入る想定。
examples: dir — 実際の使い方を示すサンプルスクリプトやシナリオ。導入時の動作確認やチュートリアルに利用可能。

…他 3 ファイル

以下、各要素の利用イメージ（詳細説明）

daemon ディレクトリ: ログ取り込み、テキスト抽出、重複チェック、ストアへの追加といったパイプラインを担うスクリプト群が含まれることが想定されます。シェルベースの実装なので、簡単にシステムの cron や systemd に組み込めます。
examples ディレクトリ: Claude Code セッションから出力を収集し、保存されたメモリを新しいプロンプトへ注入する一連の流れを示すサンプル。導入の初期ハードルを下げる資料になります。
README.md: セットアップ手順、環境変数（APIキーなど）の設定、起動コマンド、運用上の注意点（保存データの扱いやフィルタリング）についての説明が含まれているため、運用開始前に一読することを推奨します。

まとめ

Claude Code の忘却問題を実務的に補う、軽量で実践的なセマンティックメモリ実装です。

リポジトリ情報：

名前: claude-code-semantic-memory
説明: Persistent semantic memory system for Claude Code
スター数: 13
言語: Shell
URL: https://github.com/zacdcook/claude-code-semantic-memory
オーナー: zacdcook
アバター: https://avatars.githubusercontent.com/u/248946058?v=4

READMEの抜粋：

Claude Code Semantic Memory System

A persistent memory system for Claude Code that extracts learnings from past sessions and injects relevant context on every prompt.

The Problem

Claude Code sessions are stateless by default. Every time context compacts or you start a new session, Claude forgets:

Solutions you already discovered together
Gotchas and traps you identified
Your infrastructure details and preferences
Decisions you made and why

This leads to repeated mistakes, redund…

Claude Code セマンティックメモリシステム