lucasrosati/claude-code-memory-setup

What it solves

このプロジェクトは、Claude Code に持続続的な長期記憶とコードベースの認識能力を提供するための包括的な設定を提供します。主に 2 つの問題を解決します：セッション間の「失念症」 (ユーザーがプロジェクトを再説明する必要がある場合) と、Claude が新しいセッションごとに構造を理解するためにコードベース全体を再読み込みすることによる高額なトークン消費量です。

How it works

システムは、コンテキストを管理するために多層的なアプローチを採用しています：

• Persistent Memory: Obsidian Zettelkasten ボルトは「第二の脳」として機能し、決定事項、アーキテクチャ、セッションログを保存します。Claude Code は CLAUDE.md ファイルと /resume や /save といったカスタムコマンドを使用して、このボルトにアクセスします。
• Codebase Mapping: Graphify を統合し、コードをクエリ可能な知識グラフに変換します。生のファイルを読み込む代わりに、Claude は構造マップ (AST-based) をクエリリングします。これにより、トークン使用量を大幅に削減できます。
• Chat Pipeline: Python ベースのインポートパイプラインが、Claude の会話 (CLI と Web app 両方) をインデックス化されたノートとして Obsidian ボルトにエクスポートします。
• Auto-Save Safety Net: Claude Code の SessionEnd フックとして登録された Python スクリプトが、ユーザーが手動保存を忘れた場合、セッションの事実を自動的に抽出してボルトに最小限のログを書き込みます。

Who it's for

API コスト (tokens) を削減し、プロジェクトの決定事項やコードベースの構造を、複数のセッションにわたって継続的かつ検索可能な知識ベースとして維持したい Claude Code を使用する開発者です。

Highlights

• Token Efficiency: ファイルの全読み込みをグラフクエリに置き換えることで、セッションあたりのトークン使用量を最大 71.5 倍削減できると主張しています。
• Zettelkasten Integration: Obsidian における原子化された相互リンクされたノートを使用し、宣言的なメモリを使用します。
• Local Processing: コードベースのグラフは tree-sitter AST を介してローカルで処理されます。これにより、デフォルトモードではコードの内容がマシンを離れないことが保証されます。
• Automated Sync: チャット履歴を知識ボルトに同期するための cron-scheduled スクリプトが含まれています。