supermemoryai/opencode-supermemory

opencode‑supermemory

何であるか – OpenCode AIコーディングアシスタント用のプラグインで、セッションやプロジェクト間で永続的かつ検索可能なメモリを提供します。Supermemoryサービス（https://supermemory.ai）と連携し、ユーザーの好み、プロジェクトのアーキテクチャ、エラー解決パターン、会話のスニペットなどの「メモリ」を保存・取得します。

主な機能

• 自動保存 – 一定の会話回数（設定可能）ごとに会話がSupermemoryに保存され、セッション終了時に残った会話はフラッシュされます。
• コンテキストの注入 – セッションの最初のメッセージで、エージェントは要約されたプロフィール、プロジェクトメモリのリスト、（オプションで）個人メモリの意味的検索結果を受け取ります。ユーザーが明示的にプロンプトを要求する必要はありません。
• 論理的なリコール – 回答する前に、メモリ検索が役立つか判断します。役立つと判断された場合、supermemoryツールを実行し、結果は自動承認されてモデルリクエストに挿入されます（設定可能な最大数まで）。
• キーワードの促し – 「remember」や「save this」などの言葉（またはカスタム正規表現）を発言すると、即座に保存が強制されます。
• コードベースのインデックス化 – /supermemory-index（または /supermemory-init）コマンドにより、エージェントがリポジトリを探索し、構造的・パターン情報を保存します。
• コンパクションメモリ – OpenCodeのコンテキストウィンドウがしきい値に達すると、プラグインは関連するメモリを要約ステップに追加し、要約結果を新しいメモリとして保存します。
• プライバシー – <private>…</private> で囲まれた内容は保存前に削除されます。
• ステータス通知 – 小さな非侵襲的なトースト（またはTUIメッセージ）で、メモリの保存・リコール、または新しいプラグインバージョンの利用可能状況をユーザーに通知します。

インストールと設定

bunx opencode-supermemory@latest install   # OpenCode V1 および V2 の両方に対応するプラグインを登録
bunx opencode-supermemory@latest login      # または config ファイルに SUPERMEMORY_API_KEY を設定
bunx opencode-supermemory@latest status     # 接続性を確認

インストーラーは、両方のバージョンに対応する ~/.config/opencode/opencode.jsonc に適切なエントリを書き込み、/supermemory-index コマンドも作成します。チャット内コマンド（/supermemory-init、/supermemory-login など）も提供されています。

使い方

• エージェントは自動的にメモリコンテキストを受け取ります。また、ツールを直接呼び出すこともできます：

  {"mode": "search", "query": "how to build with bun"}
  

• /supermemory-index を実行して、エージェントがリポジトリをスキャンし、メモリを充填させます。
• キーワードフレーズを使用するか、カスタム正規表現（設定ファイルの keywordPatterns）を追加して、手動保存をトリガーします。

設定（すべてオプション。~/.config/opencode/supermemory.jsonc または環境変数で保存）

設定	意味
SUPERMEMORY_API_KEY	Supermemoryサービス用のAPIキー
captureEveryNTurns	自動保存間の会話回数（デフォルト 3）
recallMode	direct（各プロンプトで自動検索）、advisory（エージェントが判断）、off
maxMemories	各リクエストに挿入される最大メモリ数
keywordPatterns	一致時に保存をトリガーする追加の正規表現
compactionThreshold / compactionEnabled	要約をトリガーするしきい値と、OpenCode 2 のネイティブコンパクションを強化するかどうか
SUPERMEMORY_DEBUG=1	デバッグ用に内部のリコール判断のログを表示

サポートされるスコープとタイプ

• スコープ：user（個人）または project（デフォルト）。タグはGitリモートまたはファイルシステムパスから導出され、Claude Code、Codex、Cursorなどと同一のコンテナが使用されます。
• タイプには project-config、architecture、error-solution、preference、learned-pattern、conversation が含まれます。

ライセンス – MIT。

---

すべての詳細はリポジトリの README から直接取得されています。