dezgit2025/auto-memory

auto‑memory – AIコーディングエージェント向けセッションリコール

概要

• GitHub Copilot CLI、Claude Code、Codex CLIなどのツールが使用するローカルSQLiteセッションストアを読み取る、依存関係ゼロの小型CLI（session‑recall、バックエンド固有のコマンド）を提供します。
• 読み取り前に、ストアのスキーマバージョンを確認します。ストアの形式が変更された場合（例：新しいOpenAI‑Codexリリース）、ツールは安全に停止し、修復ワークフローを起動できます。
• 修復は、パッケージにバンドルされた事前レビュー済み修正、またはCodex CLI（GPT‑6 Astra）に新しいリーダーの提案を依頼するAI支援修正のいずれかです。候補は合成データでテストされ、適用前にユーザーが承認する必要があります。
• すべての操作は読み取り専用です。ユーザーが明示的に修復を適用しない限り、元のセッションデータベースは変更されません。

重要性

• AIコーディングエージェントは、セッションストアのスキーマが変更されるとコンテキストを失います。互換性のあるリーダーがないと、エージェントは「記憶喪失」のように見え、以前の作業を思い出せません。
• auto-memoryは、クエリあたりわずか数十トークン（「最後の10セッション」で約50トークン）でそのリコールを復元し、過去の作業を再説明するために費やされるトークン予算を大幅に削減します。

入手方法

• 分離されたPythonツールマネージャーで一度インストールします（推奨：pipxまたはuv）。READMEには、macOS（Homebrew Python 3.14）およびLinux/WSL向けの正確なコマンドが記載されています。
• インストール後、使用するバックエンドのヘルスチェックを実行します。例：

  session-recall health                     # Copilot CLI
  SESSION_RECALL_ENABLE_CLAUDE_BACKEND=1 session-recall-cc health   # Claude Code
  session-recall-codex schema-check        # Codex CLI
  

• GitHubタグv0.6.0（唯一のリリース版）をピン留めして、未リリースの新しいコミットを誤って取得しないようにします。

一般的なワークフロー

1. 互換性を確認 – session-recall-codex schema-check。
2. 互換性がある場合 – ストアをクエリします（例：session-recall list --json --limit 10）。
3. 互換性がない場合 – session-recall-codex-fixで修復を開始します。ツールは次のことを行います：
   • バンドルされた修正を探して自動的に適用する、または
   • AIが提案した修正を生成し、合成テストを実行して、差分を表示します。
4. 候補を承認（session-recall-codex-fix approve …）して適用します。問題が発生した場合は、session-recall-codex-fix rollback …でロールバックできます。

サポートされているバックエンド

バックエンド	ステータス	アクティベーション
GitHub Copilot CLI	✅ 準備完了（デフォルト）	session-recall
Claude Code	🟡 オプション（環境変数を設定）	session-recall-cc
Codex CLI	✅ リコール＋レビュー済み修復、実験的なAI修復	session-recall-codex
VS Code / JetBrains / Neovim	🟡 オプション（追加のインストール手順）	deploy/install-other-backends.mdを参照

対象ユーザー

• AIコーディングアシスタントに依存し、再プロンプトなしでエージェントが以前のセッションを記憶できるようにしたい開発者。
• 複数のAIバックエンド（Copilot、Claude、Codex）を実行し、ローカルセッション履歴を公開する単一の軽量ツールが必要なチーム。
• 過去の作業を繰り返し再説明することによるトークン予算の浪費を懸念するすべての人。

制限事項

• AI支援修復パスは実験的であり、現在macOSでのみ動作します（sandbox-execが必要）。
• このパッケージはHomebrewフォーミュラを提供していません。インストールは分離されたPython環境経由です。
• このツールは読み取り専用であり、明示的に修復を適用しない限り、元のセッションDBを変更することはありません。

---

クイックスタート（人間向け）

# インストール（pipxまたはuvを選択）
pipx install "auto-memory @ git+https://github.com/dezgit2025/auto-memory.git@v0.6.0"
# インストールを確認
session-recall --version
# バックエンドのヘルスチェックを実行
session-recall health                     # Copilot CLIの例
# 最後の10セッションを一覧表示（約50トークン）
session-recall list --json --limit 10

クイックスタート（AIエージェント向け）

1. deploy/install.mdを読み、その段階的な指示に従ってください。
2. requires-user-confirmationフラグを尊重し、ファイルまたはシェルrcの変更の前に確認を求めてください。
3. インストール後、適切なヘルスコマンドを実行し、session-recall …を使用してエージェントに過去の作業の記憶を与えてください。

---

ライセンス: MIT – 自由に使用、変更、再配布できます。