dezgit2025/auto-memory

何を解決するか

AIコーディングエージェントは、コンテキストウィンドウが満杯になり圧縮されたとき、または新しいセッションが開始されたときに「コンテキストの劣化」または「忘却」を経験することがあります。これにより、プロジェクトの詳細やファイルについてエージェントに再説明するのに多くの時間が浪費されます。auto-memory は、広範な検索や手動での再配置に数千トークンを消費することなく、過去のセッションから特定の事実、ファイル、要約をエージェントが再認識できるようにする手段を提供します。

動作方法

これはエージェントのメモリに対する読み取り専用の「ページフォールトハンドラ」のように機能します。アクティブなコンテキストウィンドウ（RAM）にすべてを保持するのではなく、CLIツールを使用して永続ストレージ（ディスク）から特定のデータを取得します。

• GitHub Copilot CLI 用: ローカルのSQLiteデータベース（session-store.db）から直接読み取ります。
• Claude Code 用: JSONL形式のセッションログを読み取り、構造化検索用のFTS5インデックスを構築します。
• その他のバックエンド: ファイルベースのプロバイダーを通じて、VS Code、JetBrains、Neovimからのセッションも再認識できます。

エージェントは、タスクを実行する前に、最近のファイルやセッション要約についての状況把握を行うために、session-recall コマンドを実行するよう指示ファイルで指示されます。

対象ユーザー

AIコーディングエージェント（特にGitHub Copilot CLI、Claude Code、IDE統合エージェント）を使用しており、「コンテキストの減少による悪循環」を避け、AIアシスタントの再配置に費やす時間を削減したい開発者向けです。

特徴

• ゼロ依存: Python標準ライブラリのみを使用して構築されています。
• 読み取り専用: 基盤となるセッションデータベースやログに一切書き込みません。安全を確保します。
• トークン効率的: 手動のgrep/find操作に数千トークンを消費するのに対し、約50トークンで特定のコンテキストを再認識できます。
• マルチバックエンド対応: Copilot CLI、Claude Code、さまざまなIDEと連携可能です。
• エージェント指向のインストール: AIエージェントが自律的にツールをインストール・設定するためのプロトコルを含んでいます。