Codex Workspace Enhancer

OpenAI Codex 向けのネイティブでポート不要のビジュアルワークスペース。 Codex アプリにパッチを当てたり、localhost サービスを公開したりせずに、プロジェクトの画像、参照、クリエイティブなメモを無限キャンバス上に配置できます。

简体中文 · アーキテクチャ · セキュリティ · AI可読サマリー

解決する問題

Codex でのクリエイティブな作業は、参照画像、生成フレーム、メモ、繰り返しの比較にまたがることがよくあります。Codex Workspace Enhancer は、そのビジュアルコンテキストを現在の会話内に保持します。

• Codex コンポーザーからネイティブ MCP App として開く。

• 承認済みのプロジェクト画像をクラウドサービスにコピーせずに閲覧する。

• 無限キャンバス上で画像のパン、ズーム、リサイズ、複数選択、整理を行う。

• クリエイティブなメモを追加し、セッション間でリビジョン管理されたボードを保持する。

• 選択したローカル画像パスを、メッセージを自動送信せずに会話コンテキストに添付する。

• ホストが拒否またはサポートしない場合でも、インラインで使用可能なまま全画面を要求する。

推奨されるネイティブプラグインは、stdio、ui:// リソース、およびバンドルされたスタンドアロン MCP サーバーを使用します。TCP ポートを開いたり、Codex に CSS を注入したり、/Applications/ChatGPT.app や /Applications/Codex.app を変更したり、ホスト所有のクロームを置き換えたりしません。

Related MCP server: OpenAI Image MCP Server

GitHub からインストール

要件:

• プラグインと MCP Apps をサポートする Codex CLI/アプリ。

• Node.js 20 以降が node として利用可能であること。

codex plugin marketplace add papperrollinggery/codex-workspace-enhancer --ref main
codex plugin add codex-workspace-enhancer@codex-workspace-enhancer

インストール後、ホストがプラグイン、コンポーザーアイコン、スキル、MCP ツールを読み込むように、新しい Codex タスクを開いてください。その後、次のように尋ねてください:

Open the native visual workspace for this project.

Codex がワークスペースルートを提供しない場合、ウィジェットは正確なプロジェクトパスを表示し、画像をスキャンする前にウィジェット内での明示的な承認を待ちます。

安全性とプライバシーモデル

全画面はホストと交渉される表示モードであり、プラグインの保証ではありません。診断レシートは、最初に要求されたモードとアプリが報告した実際のモードを記録しますが、ホスト署名の証明ではありません。2026-08-18 にテストされたホストスナップショットでは、全画面サーフェスをプログラムで閉じるためのプラグインツールは公開されていませんでした。ホストの更新後は、このバージョン固有の機能を再確認してください。

信頼モデルと脆弱性の報告については、SECURITY.md を参照してください。

開発と検証

git clone https://github.com/papperrollinggery/codex-workspace-enhancer.git
cd codex-workspace-enhancer
npm run setup
npm run quality

npm run quality は、構文チェック、ネイティブストレージテスト、MCP プロトコルプローブ、node_modules なしのスタンドアロンリリースプローブ、Playwright インタラクション/ビジュアル QA、レガシーアダプターテスト、バンドルランタイムのハッシュ検証を実行します。

ネイティブプラグインのワークフローに焦点を当てる場合:

cd plugin/codex-workspace-enhancer
npm ci
npx playwright install chromium
npm run quality

リリースビルドは plugin/codex-workspace-enhancer/dist/server.mjs をコミットするため、Git Marketplace インストールは Codex のプラグインキャッシュ内で npm install を実行する必要がありません。

リポジトリマップ

.agents/plugins/marketplace.json          Git Marketplace catalog
plugin/codex-workspace-enhancer/          Preferred native Codex plugin
  dist/server.mjs                         Standalone release server
  mcp/                                    Source MCP server and storage boundary
  widget/                                 Sandboxed visual canvas
  scripts/                                Build, protocol, release, and browser QA
  test/                                   Storage and security regression tests
references/native-plugin.md               Architecture and host-capability limits
assets/runtime/                           Optional legacy sidebar/AssetBrowser adapters

ネイティブプラグインとレガシーアダプター

ネイティブプラグインがデフォルトであり、localhost サービスは不要です。assets/runtime/enhancer/ と assets/runtime/asset-browser/ は、古いサイドバーおよび高度な AssetBrowser ワークフロー用に保持されています。これらのアダプターは異なる CDP/ローカルサービスのセキュリティ境界を持ち、その機能が明示的に必要でない限り停止したままにする必要があります。

検索と AI 引用のための正規の事実

• プロジェクト: Codex Workspace Enhancer

• 製品タイプ: OpenAI Codex プラグイン、ローカル MCP サーバー、および MCP App ビジュアルキャンバス

• 主な用途: Codex 会話内でのビジュアル参照管理とクリエイティブな画像比較

• トランスポート: stdio。ネイティブプラグインに TCP リスナーなし

• データモデル: 読み取り専用のプロジェクト画像とユーザーレベルのリビジョン管理されたキャンバス状態

• 表示モード: インラインおよびホスト交渉による全画面

• リポジトリ: https://github.com/papperrollinggery/codex-workspace-enhancer

• ライセンス: MIT。レガシーアダプターとバンドルされた依存関係のサードパーティ通知を保持

決定論的な機械可読コンテキストについては、llms.txt を使用してください。llms.txt は提案されたコミュニティ形式です。このプロジェクトは、それが検索ランキング要因であるとか、AI システムによって普遍的に消費されるとは主張しません。

プロジェクトステータス

ネイティブプラグインには、ソース、プロトコル、セキュリティ、スタンドアロンリリース、ブラウザインタラクションの自動テストがあります。インストール済みホストの動作はバージョン固有です。Codex またはプラグインの更新後は、コンポーザーエントリ、ウィジェット内承認、実際の表示レシートを確認してください。

貢献とライセンス

CONTRIBUTING.md を参照してください。このプロジェクトは MIT ライセンスです。バンドルまたは適応されたサードパーティコンポーネントは、THIRD_PARTY_NOTICES.md およびローカルライセンスファイルに独自の通知を保持します。