CLI、API、MCP

アプリで行えることはすべて、ウインドウなしでも操作できます。アプリのバイナリ — Bromure Agentic Coding.app/Contents/MacOS/ 内の bromure-ac — は、複数のコマンドを持つ CLI であり、HTTP の制御プレーンであり、外部の AI ツール向けの MCP サーバーであり、AppleScript の対象でもあります。各 VM の内部では、組み込みの MCP サーバー群がエージェントに Bromure 独自のビューを提供します。この章はそれらすべてのリファレンスです。

外側から内側へ、インターフェイスは次のとおりです。

• bromure-cli コマンドライン — マシン、VM、ターミナル、コマンド、トレース、モデル、リモートアクセス、登録を扱う Docker/kubectl 風の CLI。
• 制御プレーン — 同じ操作を HTTP 上の JSON で提供します。所有者専用の Unix ソケット上で、またオプションでループバックの TCP ポート上で動作します。
• AC MCP サーバー（bromure-ac mcp） — Mac 上の AI ツール（Claude Code、Claude Desktop）にアプリを管理させます。
• ゲスト内の MCP サーバー — すべての VM に組み込まれています。ブラウザ、オートメーション、インフラ、委任、そして特定のセッション向けにタスクボードとスイッチボードです。
• AppleScript — Bromure AC Suite 用語辞書。

この章でも CLI でも、マシンはワークスペースと呼ばれます（設定エディタとコマンドラインでの名前です）。エージェントとの会話という意味でのセッションには /agent-sessions ルートでアクセスします。古い /sessions ルートや、CLI と AppleScript における session という語は、マシンのウインドウを指します。

制御プレーン: ソケットと API

各インターフェイスは、2 つのトランスポートのいずれかを介して、実行中のアプリと HTTP で通信します。

CLI が VM と直接通信することはありません。各サブコマンドはコントロールソケット上の薄い HTTP クライアントなので、同じコマンドがローカルでも、またソケットが SSH でトンネリングされている場合はリッチクライアントからリモートインスタンスに対しても機能します。エージェントを必要とするコマンドを実行したときにエージェントが動いていなければ、CLI はウインドウのないバックグラウンドエージェント（bromure-ac run --headless）を自動起動し、/health に応答するまで最大 40 秒待ちます。読み取り専用のコマンド（vm ls、describe、trace …）は自動起動せず、代わりに No bromure-ac agent running. と表示します。

注: コントロールソケットはアプリの実行中は常に利用でき、オートメーションサーバーを有効にする スイッチとは無関係です。このスイッチが制御するのはポート 9223 の TCP リスナーだけです。CLI を使うためにオートメーション API を有効にする必要はありません。

bromure-cli コマンドライン

バイナリはバンドル内のフルパスで呼び出せますが、短い名前のほうが便利です。アプリメニューで Bromure Agentic Coding › コマンドラインツールをインストール… を選びます。コマンドラインツール「bromure-cli」をインストールしますか？ というアラートが、/usr/local/bin/bromure-cli にシンボリックリンクを作成し、管理者パスワードが一度必要になることを説明します。インストール（または キャンセル）をクリックします。成功すると、コマンドラインツールをインストールしました が bromure-cli --help を実行するよう案内します。アプリが起動時にこれを提案することはもうありません — メニュー項目が唯一の入り口で、いつでも再実行できます（たとえばアプリを移動した後など）。

同じバイナリでも、呼び出されたときの名前によって動作が変わります。

• bromure-cli として呼び出すと、アプリ内部のコマンド — イメージ管理（init、info、reset と公開パイプラインのツール）、mcp サーバー、GUI の既定である run — を隠し、ターミナル向けのグループ（Workspaces、Tracing、Local inference、Enterprise features、remote）だけを公開します。引数なしの bromure-cli は、アプリを起動せずにヘルプを表示します。
• bromure-ac として（アプリバンドル内のバイナリ）呼び出すと、すべてが利用でき、既定のサブコマンドは GUI を起動する run です。

以下の例では bromure-cli を使います。bromure-ac だけが公開するコマンドには、フルパス …/MacOS/bromure-ac を使ってください。

ワークスペース引数が示されている箇所では、コマンドはワークスペースの ID、短縮 ID のプレフィックス、または名前を受け付けます。コマンドグループ vm と workspaces は互いのエイリアスです。マシンとは何か、そしてセッションとどう関係するかは、マシンで説明しています。

アプリとバックグラウンドエージェント

イメージ管理

ベースイメージは一度だけインストールします。これらのコマンドは bromure-ac の名前でのみ存在します。

注: ベースイメージが存在しない場合、GUI を起動するとオンボーディングウィザードに案内され、その場でイメージがインストールされます — インストールと初回起動を参照してください。

ワークスペースと VM の制御

これがコアグループです。vm run は意図的に Docker 風になっています。ワークスペースを起動し、ゲストの共有 bromure tmux セッションにターミナルを渡します。

知っておくと役立つ運用上の詳細をいくつか。

• vm run のフラグ。 --tool はエージェント ID を取ります: claude、codex、grok、kimi、omp。--auth は token、subscription、bedrock、local のいずれかです。認識できない値はエラーとなり、有効な値が一覧表示されます。たとえば Invalid --tool “gpt” — expected one of: claude | codex | grok | kimi | omp. です。workspaces create も --tool と --auth を同じようにチェックします。-v/--volume <hostdir> はホストのフォルダをゲストの ~/<basename> にマウントします（繰り返し指定可、最大 8）。-d/--detach は VM を起動してアタッチせずに戻ります。--rm は VM の停止時にワークスペースとそのディスクを削除します。アタッチ中の tmux からは Ctrl-b d でデタッチします — VM は動き続けます。
• エージェントはモデルから決まります。 ツールと認証のフラグは、新しいワークスペースの初期値を与えるだけです。各エージェントが実際に使うモデルとプロバイダーは、環境設定 › モデル とワークスペース自身のモデルペインで決まります — モデルとプロバイダーを参照してください。
• TTY を認識します。 ターミナルを tmux に渡すという Docker 風の既定動作は、本物のターミナルでのみ適用されます。パイプやスクリプトからの呼び出しは、-d を渡したかのように動作します。
• workspaces create の値。 色は blue、red、green、orange、purple、pink、teal、gray のいずれかです。
• 編集時の空欄保持。 workspaces edit はシークレットを空欄にした構成全体をエクスポートします。空欄のシークレットを含むドキュメントを保存すると保存済みの値が保持されるため、往復で鍵が消えることはありません。変更のないバッファは何も保存しません。無効な JSON は中止されます。
• Exec の待機。 vm exec はゲストのシェルエージェントを最大 10 秒待ちます。502 は VM が実行されていないか名前が一致しなかった可能性を意味します。接続中のセッション中に発生する承認プロンプトは、ゲスト内ではなく あなたの ターミナルにレンダリングされます（接続ターミナル上での同意 を参照）。

コマンドラインからのディスクチェック

vm fsck は、ext4 ブラウザの fsck を実行… と、ファイルシステムエラーで起動が止まったときにアプリが表示する ディスクを修復 ボタンの、スクリプトで使える双子です。Bromure 独自の ext4 チェッカーを使うため、何もインストールする必要はありません。

bromure-cli vm kill "Web app"            # the workspace must be stopped
bromure-cli vm fsck "Web app"            # check the system disk, report only
bromure-cli vm fsck "Web app" --repair   # replay the journal, clear the error flag
bromure-cli vm fsck "Web app" --home     # check the home image instead

ワークスペースの実行中は実行を拒否します。出力は次のいずれかの要約で終わります: 「Filesystem is clean.」、「Filesystem repaired; it is now consistent.」、「Filesystem has errors this checker cannot repair.」。--repair なしのチェックで問題が見つかると、--repair を付けて再実行するよう提案されます。エラーが残っている間、コマンドは終了ステータス 4 で終わります。チェッカーの範囲と制限は高度な操作で説明しています。

モデル、ルーティング、Fusion

モデルとプロバイダーの設定はモデルとプロバイダーで、マルチモデルの統合は Fusion で扱います。CLI のトグルは次のとおりです。

トレース検査

これらはワークスペースごとのプロキシトレースを読み取ります。ワークスペースでトレースが有効になっていない限り何も返しません — トレース設定を参照してください。全体像はトレースと監査にあります。

リモートアクセス

オプションの SSH 玄関口はデフォルトで無効になっており、リモートアクセスとクライアントで詳しく説明しています。すべての操作は、コントロールソケットを介して実行中のアプリを通ります。

エンタープライズ登録

スクリプトによるデバイスプロビジョニング用の、bromure.io にログイン… シートの CLI 対応版です。エンタープライズ を参照してください。

統合コマンドと内部コマンド

リモート TUI（__remote-menu）

SSH リモートアクセスが有効な場合、すべてのリモートログインは（ForceCommand により）シェルではなく独自実装の ANSI ターミナル UI に強制されます — 矢印キーと数字で操作する、代替画面・256 色のメニューで、任意の SSH PTY 上で動作します（ssh -t を使ってください）。CLI をメニューとして反映しています。

• ワークスペース — 1 画面のフォームでの作成（Name、Tool、Auth、API key、Memory、Color、Folders、Generate SSH、Full settings…、Create）、ワークスペースごとの操作（実行中のものには Attach、New tab、Describe、Configure…、Fusion、Routing、Worktrees…、Reboot…、Suspend、Kill、停止中のものには Start、Describe、Configure…、Delete）、そして生のテーブル表示。Configure… は設定エディタのペインをテキストフォームとして提供します。モデルはアプリで選ぶため、その Models フォームは読み取り専用です（サーバーのプロバイダーと、ワークスペースがそれを上書きしているかどうか）。
• Models — インストール済みモデルとダウンロードカタログ。未インストールのモデルを選ぶと、ライブ進捗付きでインラインで model pull するよう提案します。
• Trace — Summary / Hostnames / Leaks / Recent / Clear。

ワークスペースの tmux にアタッチしている間は、マジックキーコード（既定は Ctrl-]、バナーに表示されます）でホストが描画するコントローラーオーバーレイが開きます: タブツリー、New tab、Worktrees…、Fusion、Routing、Edit settings…、Reboot…、Suspend、Disconnect。ゲストがトリガーキーを見ることはありません — remote/overlay-key ファイルまたは $BROMURE_OVERLAY_KEY で変更できます。Ctrl-b d で tmux から切断してメニューに戻ります。リモート TUI が扱うのはマシンとそのターミナルです。エージェントセッション、ルーム、スイッチボードにはリッチクライアントからアクセスします。リモートの全体像はリモートアクセスとクライアントにあります。

ループバック自動化 API

制御プレーンは、任意の言語からスクリプトで使えるよう、TCP 上の HTTP で JSON として公開することもできます。デフォルトではオフです。

有効化する

環境設定… › オートメーション（⌘,）を開きます — オートメーション API と MCP サーバー ペインです。

1. 自動化サーバーを有効にする をオンにします。オンのとき、ペインには 127.0.0.1:9223 でリッスン中 と表示されます。オフにするとサーバーは即座に停止します。
2. 必要に応じて ポート（キャプションは （既定: 9223））と バインドアドレス（既定は 127.0.0.1）を設定します。ポートとバインドアドレスは次回のサーバー起動時に有効になります — すぐに適用するには、スイッチをオフにしてからオンに戻します。

GUI を使わずにスイッチを切り替えることもできます。

defaults write io.bromure.agentic-coding automation.enabled -bool true

警告: バインドアドレス を 127.0.0.1 以外に設定すると、API — およびそれが支える MCP サーバー — がネットワークに公開され、ペインは ループバック以外へのバインドは API をネットワークに公開します。MCP サーバーには認証がありません。 と警告します。TCP リスナーには、ループバック境界と下記の BROMURE_DEBUG_CLAUDE ゲートを超える認証はありません。信頼できる特定の理由がない限り、バインドアドレスはループバックのままにしてください。

認証モデル

TCP リスナーと制御ソケットは 同じ ルートを提供しますが、アクセスが異なります。

つまり、コントロールソケットは所有者専用のフルアクセス経路です。TCP API はループバック上で安全なサブセットだけを開放し、それ以外はすべてデバッグフラグの背後に置きます。パスセグメントは一度だけパーセントエンコードされます（そのため、スペースを含むワークスペース名も機能します）。

スクリプト用のエンドポイント

最も有用なルートは次のとおりです。

制御ソケットのパスには空白が含まれるため、まず変数に取り込みます。

SOCK="$HOME/Library/Application Support/BromureAC/control.sock"

# Full mirror snapshot (control socket only)
curl --unix-socket "$SOCK" http://localhost/state

# List running VMs
curl --unix-socket "$SOCK" http://localhost/vms

# Boot a workspace by name
curl --unix-socket "$SOCK" -X POST http://localhost/vms \
  -d '{"profile":"Web app"}'

# Answer a queued lifecycle prompt with one of its offered button labels
curl --unix-socket "$SOCK" -X POST http://localhost/prompts/PROMPT_ID/answer \
  -d '{"choice":"Not Now"}'

安全なサブセットは、有効にした後の TCP API 上で機能します — たとえば、ワークスペースの一覧表示やマシンのウインドウを開く操作には、デバッグフラグは不要です。

curl http://127.0.0.1:9223/profiles
curl -X POST http://127.0.0.1:9223/sessions -d '{"profile":"Web app"}'

注: 制御プレーンのルートはリッチクライアントと共有される統合用インターフェイスであり、バージョン管理された公開 API ではありません。リクエストとレスポンスの形はリリース間で変わることがあります。上記の CLI コマンドが、Bromure をスクリプトで操作する安定した方法です。デバッグ専用のルート、環境変数、ファイルの場所は付録にまとめています。

AC MCP サーバー（bromure-ac mcp）

bromure-ac mcp は stdio の JSON-RPC MCP サーバー（サーバー名 bromure-ac）を実行し、Mac 上の AI ツールがアプリを管理できるようにします。HTTP のオートメーション API と AppleScript をラップしているため、先にオートメーションサーバーを有効にしてください — 一覧表示とウインドウのツールは --api-url（既定は http://127.0.0.1:9223）の HTTP API を呼び出します。bromure-cli の名前では利用できません。

公開するツールは次のとおりです。

• bromure_ac_list_profiles、bromure_ac_list_sessions
• bromure_ac_open_session（ワークスペースのウインドウを開きます。最大 30 秒待ちます）、bromure_ac_close_session
• bromure_ac_get_profile、bromure_ac_set_profile（アトミックな JSON 置換、id は保持）
• bromure_ac_get_profile_setting、bromure_ac_set_profile_setting

--debug（かつアプリに BROMURE_DEBUG_CLAUDE が設定されている）を使うと、bromure_ac_app_state、bromure_ac_vm_exec、bromure_ac_vm_read_file、bromure_ac_vm_write_file が追加されます。

Claude Code に接続するには、次の内容を ~/.config/claude-code/.mcp.json（またはお使いのクライアントの同等のファイル）に追加します。これは、オートメーションペインの MCP クライアント設定 セクションに表示されるスニペットそのものです。

{
  "mcpServers": {
    "bromure-ac": {
      "command": "/Applications/Bromure Agentic Coding.app/Contents/MacOS/bromure-ac",
      "args": ["mcp"]
    }
  }
}

メモ: get/set プロファイルツールは osascript（実行中のアプリに対する AppleScript）にシェルアウトするため、GUI アプリが実行中である必要があり、macOS は自動化権限を一度求めることがあります。プロファイル JSON は、BROMURE_DEBUG_CLAUDE が設定されていない限りシークレットを空欄にして伝わります。

VM 内の MCP サーバー

AC MCP サーバーとは別に、Bromure はすべての VM 内のエージェントに組み込みの MCP サーバー群を提供します — 設定は不要です。それぞれは小さな Python の stdio シムで、ゲストの /mnt/bromure-meta/ に読み取り専用で配置されます。シムは vsock 経由でホストに接続し、切断されても無期限に再接続するため、エージェントがツールを失うことはありません。ツールを提供するのはホストで、すべての呼び出しはそこでチェックされます。エージェントが見たり操作したりできるのは、自身のマシンとセッションに権限があるものだけです。

browser、automations、infrastructure、delegation の各サーバーは、マシンの MCP ペインで追加したサーバー（MCP 設定）と並んで、各エージェント自身の MCP 設定に書き込まれます。task board と switchboard のサーバーは、それを必要とする実行にだけ渡されます。

browser サーバー

browser サーバーは、専用の使い捨て VM で動くマシンの組み込み Chromium を操作します。23 個のツールがナビゲーションと検査をカバーします — browser_navigate、browser_new_tab、browser_list_tabs、browser_activate_tab、browser_close_tab、browser_back、browser_forward、browser_reload、browser_screenshot（ページ全体のオプション付き）、browser_evaluate、browser_get_text、browser_get_html、browser_get_links、browser_click、browser_fill、browser_type、browser_press_key、browser_wait_for、browser_network、browser_network_summary、browser_clear_network、browser_console、そして browser_pick_element（60 秒間の対話型要素ピッカー）です。

ブラウザが閉じているときにツールを呼び出すと、ブラウザを開いてコールドブートを待ちます。ブラウザは別の VM なので、サーバーの指示はエージェントに、自分のマシン上の開発サーバーへはマシンの LAN IP（hostname -I）で到達し、決して localhost を使わないよう伝えます。全体像は組み込みブラウザにあります。

注: リッチクライアントでは、エージェントのブラウザ MCP ストリームを SSH 接続で運べるため、リモートのエージェントがローカルで見ているブラウザペインを操作します。リモートアクセスとクライアントを参照してください。

追加した MCP サーバーの OAuth

エディタで追加する HTTP MCP サーバーは、ホスト側の OAuth ブローカーを通じて認証できます: RFC 8414 ディスカバリと RFC 7591 動的クライアント登録（Bromure AC として）を実行し、システムブラウザで PKCE 認可コードフローを実行し、ループバックリスナー（ポート 28500～28599）でコールバックを提供します。成功ページには Authorized — You can close this tab and return to Bromure AC. と表示されます。フロー全体はホスト上で実行されるため、VM が実際の OAuth 認証情報を見ることはありません。

AppleScript（Bromure AC Suite）

スクリプト用語辞書 Bromure AC Suite も、オートメーションのインターフェイスの 1 つです — オーケストレーションや、ウインドウ ID を必要とするスクリーンショットツールに便利です。スクリプトエディタや osascript から application "Bromure Agentic Coding" を対象にします。次をカバーします。

• プロファイル — list profiles、create ac profile <name> [color <c>]（UUID を返します）、delete ac profile <name|uuid>、そして get profile json / set profile json によるドキュメント全体の往復（プロファイル全体。ID は保持され、空欄のフィールドには保存済みのシークレットが統合されます）。
• フィールドごとの設定 — get profile setting … key … / set profile setting … key … to value …。
• エディタウィンドウ — open profile manager、open ac profile editor、close ac profile editor、select editor category <key>、および get editor window id / get main window id（screencapture -l 用の CGWindowID）。
• マシンのウインドウ — open ac session、close ac session、list ac sessions。
• アプリの状態と設定 — get app state（JSON）、および automation.enabled、automation.port、automation.bindAddress、remoteAccess.enabled、remoteAccess.port、remoteAccess.bindAddress、managed.serverURL、managed.acIngestURL の各キーに対する get ac app setting / set ac app setting。automation.enabled を設定すると HTTP サーバーがライブで切り替わります。

たとえば、マシンのウインドウを開くには次のようにします。

osascript -e 'tell application "Bromure Agentic Coding" to open ac session "Web app"'

メモ: プロファイル JSON は、BROMURE_DEBUG_CLAUDE が設定されていない限りシークレットを除去して伝わります。set profile setting で apiKey を空文字列に設定すると、鍵を保持するのではなく クリア します — JSON 往復ブリッジの空欄保持の動作とは異なります。ロケール切り替えは意図的にスクリプト化できません。代わりに、たとえば -AppleLanguages "(fr)" でアプリを再起動してください。

スケジュール自動化

スケジュールされたオートメーションは、1 台のマシンに紐づく、繰り返し実行される無人のエージェント実行です。オートメーションはオートメーションボード（⇧⌘A、またはサイドバーの オートメーション セクション）で作成・管理し、エージェントは上記の automations MCP サーバーを通じて自分のマシンのオートメーションを管理できます。機能全体 — トリガー、スケジュール、連鎖、必須のインジェクション検査、実行履歴 — は自動化で説明しています。このセクションでは制御プレーンのインターフェイスを扱います。API によるオートメーションの操作、無人の起動が発生させうる判断プロンプトへの応答、そしてアタッチしたターミナルでの同意の仕組みです。

API 上での自動化の制御

保留中のプロンプトに応答する

ライフサイクル上の判断 — ベースイメージのアップグレードの提案、起動時のチェックに失敗したディスク、侵害アラート、侵害による消去 — は、通常はローカルのアラートとして表示されます。Mac の前に応答できる人がいない場合（ヘッドレスのエージェント、またはリモートのリッチクライアントが要求した起動）は、代わりにキューに入ります。それらは GET /state の pendingPrompts の下に現れ（それぞれ id、profileID、title、message、ボタンのラベルを持ちます）、POST /prompts/<id>/answer で応答します。

SOCK="$HOME/Library/Application Support/BromureAC/control.sock"
curl --unix-socket "$SOCK" -X POST http://localhost/prompts/PROMPT_ID/answer \
  -d '{"choice":"Remind me later"}'

choice には、プロンプト自身のボタンラベルのいずれかを渡します。プロンプトのタイムアウトまでにどのクライアントも応答しなければ、安全なフォールバックで解決されます — 破壊的な選択肢には決してなりません（たとえば侵害アラートは VM のシャットダウンにフォールバックします）。クライアントがまったく接続されていなければ、即座にフォールバックします。リッチクライアントは、これらのプロンプトを通常のアラートとして表示します。

注: オートメーション、委任、その他の無人起動がプロンプトを待つことはありません。あなたの応答が必要になる起動 — 侵害済みとマークされたマシンや、まだダウンロード中のローカルモデル — は拒否され、実行履歴に明確な理由が記録されます（「The workspace is marked compromised — start it yourself to confirm the wipe.」）。保存された状態を復元できないサスペンド中のマシンは、まっさらな状態で起動します。

接続ターミナル上での同意

ターミナルがマシンに対話的にアタッチされている間 — vm exec -it、vm attach、または SSH アタッチ経由 — ホスト側の承認プロンプト（認証情報の使用など）は、ゲスト内ではなくあなたのターミナルに表示されます。プロンプトは 🔒 Bromure — approval required と番号付きの選択肢、そして Choice [1-N] (Enter or timeout = deny) を表示します。Enter、タイムアウト、EOF、デタッチはいずれも拒否を意味するため、侵害されたゲストが承認を偽造することはできません。その後、ゲストの tmux が再描画されます。

デバッグエンドポイント（BROMURE_DEBUG_CLAUDE）

BROMURE_DEBUG_CLAUDE を設定してアプリを起動すると、TCP オートメーション API のデバッグゲートが外れ、認証テーブルの中段のルートも TCP で機能するようになります。これには次のデバッグルートも含まれます（特記がない限り、コントロールソケットでは常に利用可能です）。

• GET /debug/ui-shot?path=…&which=… — アプリが自身のウインドウを PNG に描画し（画面収録の権限は不要）、サブビューのフレームのダンプを返します。既定の出力先は /tmp/bromure-ui-shot.png です。
• POST /debug/editor — スクリーンショットツール用に設定エディタを駆動します。
• POST /detect/prompt-injection — 実際の検出器を実行してその判定を返します（このルートは 制御ソケット上でも デバッグフラグを必要とします）。

このフラグは、AppleScript と MCP のプロファイル JSON ブリッジでシークレットをそのまま通すことも可能にし、bromure-ac mcp --debug の VM ツールにも必要です。GET /health は debugEnabled を報告するので、アプリがどちらのモードかを確認できます。

警告: BROMURE_DEBUG_CLAUDE は、通常 exec、VM の制御、プロファイルの生のシークレットをループバック TCP API から遠ざけている安全ゲートを取り除きます。このフラグを付けてアプリを実行するのは自分が管理するマシン上だけにし、ループバック以外のバインドアドレスとは決して組み合わせないでください — そうすると、ポートに到達できる誰にでも、VM の完全なシェルアクセス、伏せられていないシークレット、ウインドウのキャプチャが公開されてしまいます。これは BROMURE_AC_DEBUG（stderr へのイベントログ）や BROMURE_CLI_DEBUG（CLI のソケット診断）とは別物で、そちらは無害なログ用スイッチです。