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.
Context Attachment Manager
Codex、Claude Code などのエージェントで、画像が多い会話のためのローカルプラグイン。
以前の画像をメッセージごとに送り直しません。必要な画像はモデルが ID で取り出します。会話を圧縮したあとも同じです。
できること
エージェントは通常、メッセージを送るたびに以前の画像をすべて送り直します。画像が増えると会話は重くなり、送信できなくなることもあります。このプラグインは画像ごとに番号(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(英語)をご覧ください。