Skip to content

A local plugin for image-heavy chats in Codex, Claude Code and other agents: earlier images stop going out with every message, and the model fetches the one it needs by its ID, also after compaction.

7.6 KB
Raw Blame

Context Attachment Manager

Codex、Claude Code などのエージェントで、画像が多い会話のためのローカルプラグイン。
以前の画像をメッセージごとに送り直しません。必要な画像はモデルが ID で取り出します。会話を圧縮したあとも同じです。

リリース 対応 OS:Windows、macOS、Linux MIT ライセンス

English · 简体中文 · 日本語

15 枚のキーフレームがあるタスクのパネル。自動選択をオンにすると以前の画像が灰色になり、次のリクエストが 7.5 MB から 1.7 MB に減ります。

できること

エージェントは通常、メッセージを送るたびに以前の画像をすべて送り直します。画像が増えると会話は重くなり、送信できなくなることもあります。このプラグインは画像ごとに番号(IMG-001、IMG-002…)を付け、以前の画像の代わりに短いプレースホルダーを送ります。

  • 必要な画像だけ取り出す:以前の画像をもう一度見る必要があるとき、モデルが ID で元画像を取り出します。
  • どの画像か見分けられる:モデルが画像ごとに見た目の特徴を一行で記録し、あなたの評価も残します。これはプレースホルダーに入るので、会話を圧縮したあとも残ります。
  • 何も削除しない:元の画像と会話履歴はそのままです。

最初からオンで、パネルを開く必要はありません。主な用途:画像・動画の制作、スキャン文書、パソコンやブラウザーの操作。

インストール

次の文をお使いのエージェントに送ってください。実行中のプラットフォームを確認し、それに合わせてインストールします。

次の手順に従って、Context Attachment Manager をインストールしてください:https://github.com/chipfighter/context-attachment-manager/blob/main/INSTALL.md

インストール後はエージェントを再起動してください(Claude Desktop では新しい Code セッションを始めてください)。対応エージェント、インストール・更新・アンインストールの手順(英語)もご覧ください。

自分で選びたいときは、パネルで

パネル:過去の画像を自動管理し、覚えている特徴から検索して、大きくプレビューできます。

  • 覚えていることから検索:「雨の夜」「いちばん良い顔」など、画像の特徴や感想で探せます。
  • 大切な参考画像を固定:画像を開き、Send every turn(毎ターン送信)にチェックを入れます。
  • 送る画像を自分で選択:Auto-select(自動選択)をオフにして、次のメッセージに含める画像を選びます。

Codex ではタスクのサイドパネルから Context Assets を開きます。Claude Desktop の Code タブでは画像があると自動で開き、/cam で再び開けます。

プライバシー

プラグインはローカルで動作します。元の画像と会話履歴は自分のコンピューターに残り、リクエストはエージェントが元から使っているサービスに送られます。

効果の検証

Codex では、9 枚のキーフレームがある会話が 42.4 MB になり、再起動や圧縮のあとに送信できませんでした。プラグインを入れると、同じリクエストは 0.12 MB でした。結果と再現手順は Codex の比較検証と Claude Code の長期タスク検証(英語)をご覧ください。

対応エージェント

Codex と Claude Code は動作確認済みで、Codex と Claude Desktop にはパネルもあります。ほかのエージェントにも対応しています。接続層は各エージェントのコードとドキュメントをもとに書きましたが、まだ実際には試していません。お使いの方は、動いたかどうかぜひ教えてください。

エージェント 概要 対応状況
Codex OpenAI のコーディングエージェント(デスクトップ版・CLI) 自動選択+パネル、動作確認済み
Claude Code Anthropic のコーディングエージェント(デスクトップ版・CLI) 自動選択+パネル(デスクトップ版)、動作確認済み
WorkBuddy Tencent のデスクトップ AI アシスタント(CodeBuddy 内蔵) 自動選択、未検証
OpenCode どのモデルサービスにもつながるオープンソースのターミナル型エージェント 自動選択、未検証
Gemini CLI Google のオープンソースのターミナル型エージェント 自動選択、未検証
pi ミニマルで拡張できるターミナル型コーディングエージェント 自動選択(pi 拡張)、未検証
DeepSeek Harness すべてがプラグインの DeepSeek のエージェント基盤 自動選択(dsh プラグイン)、未検証
Qwen Code Qwen のオープンソースのターミナル型エージェント 自動選択、未検証
Cline VS Code・JetBrains・ターミナルで使えるオープンソースのコーディングエージェント 自動選択、未検証
Kilo Code VS Code・JetBrains・ターミナルで使えるオープンソースのコーディングエージェント 自動選択、未検証
goose MCP で拡張できる、デスクトップとターミナルのオープンソースエージェント 自動選択、未検証
Cherry Studio 多くのモデルにつながるオープンソースのデスクトップ AI チャット 自動選択、未検証

これらのエージェントの設定手順は INSTALL.md(英語)をご覧ください。ほかのエージェントを接続するには ADAPTERS.md(英語)をご覧ください。

変更履歴(英語) · 開発への参加(英語) · MIT ライセンス