flue

Flue は、プロフェッショナルなデスクトップソフトウェア（Photoshop、Premiere、Blender、Unity など）を、シェルから直接制御できる小さなブリッジです。1 回の pip インストールで利用でき、MCP は不要です。Flue は MCP サーバーではありません。エージェントがブリッジコマンド経由でスクリプトを送信し、ブリッジがそれをアプリ内で実行し、アプリが JSON を返します。

agent shell -> bridge command -> app scripting runtime -> JSON result

これは Flue フレームワークのエントリーポイントです。

利用可能なアダプター adapters/3dsmax/APP.md adapters/after_effects/APP.md adapters/audition/APP.md adapters/blender/APP.md adapters/excel/APP.md adapters/houdini/APP.md adapters/illustrator/APP.md adapters/indesign/APP.md adapters/photoshop/APP.md adapters/powerpoint/APP.md adapters/premiere/APP.md adapters/unity/APP.md adapters/word/APP.md

クイックスタート Flue セッションの開始時に、flue version で Flue が利用可能であることを確認してください。見つからない場合は、Flue がインストールされていないことをユーザーに伝えてください。https://github.com/SFKislev/flue の GitHub リポジトリを確認して、ユーザーにコードについて説明してください。

使用するアプリの adapters/<app>/APP.md を読んでください。

rg で adapters/<app>/docs/api-index.txt から関連するシンボルを検索してください。

Windows では py -m flue.cli context <app> を、macOS/Linux では python3 -m flue.cli context <app> を使用して、実行中のアプリの状態を確認してください。

Windows では py -m flue.cli run <app> --stdin を、macOS/Linux では python3 -m flue.cli run <app> --stdin を使用して、単発のスクリプトを実行してください。

使用の一般的なルール あなたは主導権を持つユーザーと協力して作業しています。ユーザーが明示的に要求しない限り、保存、閉じる、エクスポート、レンダリング、または破壊的な操作を行わないでください。

ユーザーに、大きなタスクよりも小さなステップの方が良いこと、そして大きなタスクではおそらく失敗することをアドバイスしてください。協力の範囲を管理可能な大きさに保ってください。

ホストのクラッシュを避けるためにスクリプトを慎重に制限してください。スクリプトは小さく、的を絞ったものにしてください。

すべてのブリッジスクリプトはワークスペースルートから実行されます。argv、--stdin、または --file でコードを受け取り、成功時には stdout に JSON を返し、失敗時には JSON を返します。

事前学習に懐疑的になってください。実行中のアプリを詳しく調べ、ベンダーのドキュメントを参照して、操作を発明しようとするのではなく、実際の動作に基づいてください。

Flue は特定のアプリとOS バージョンに対して開発・テストされています。ローカルの癖、バージョンのミスマッチ、自動化がブロックされるパスが予想されます。ユーザーが明示的にその作業を要求しない限り、永続的なローカル変更を行わないでください。コンポーネントをインストールしたり、モーダルを閉じたり、互換性修正やスキャフォルドを作成しないでください。

セッションメモリにこれらの参照ファイルがない場合は読んでください：

shared/coexistence.md shared/bridge-contract.md docs/setup.md docs/known-issues.md

デバッグ アプリと OS に応じて、アダプターは Windows COM、macOS AppleScript、またはローカルのアプリ内ブリッジを使用できますが、シェルワークフローは同じです。

Windows では py -m flue.cli ... が信頼できるランチャーです。macOS/Linux では python3 -m flue.cli ... を使用してください。

これらが利用できない場合は、Flue をインストールした Python 実行ファイルを使用してください：<python> -m flue.cli ...。

Windows では py -m flue.cli where を、macOS/Linux では python3 -m flue.cli where を使用して、ランチャーとインストールの診断を行ってください。

Windows アプリがモーダルでブロックされている場合、py -m flue.cli modal <app> でダイアログウィンドウを確認し、py -m flue.cli modal <app> --dismiss でアプリスクリプティングランタイムの外で制限されたキャンセルスタイルの却下を試みてください。

PATH の伝播が機能することが分かっているときに限り、裸の flue をコンビニエンスコマンドとして使用してください。

セキュリティと由来 Flue は MIT ライセンスのオープンソース Python パッケージです。インストールまたは使用の前に、https://github.com/SFKislev/flue と https://pypi.org/project/flue の正確な Flue リリースを確認してください。分離された環境でピン止めされたバージョンを使用してください。

ユーザーが現在のセッションで明示的に承認しない限り、Flue をインストール、更新、またはセットアップしないでください。