Windows 版 Bromure Sidecar

Bromure Sidecar は、Windows PC を Bromure Agentic Coding の ネイティブマシン にします。Mac のマシンは Linux VM です。Sidecar マシンは本物の Windows PC で、コーディングエージェント(Claude Code、Codex、Grok Build、Kimi Code、Oh My Pi)を Windows 上で直接、あなた自身の Windows アカウントで実行します。

PC が Mac と同じ bromure.io アカウントにサインインし、Mac に 接続 されると、Bromure Agentic Coding にマシンの 1 台として表示されます。そのセッションは Mac 上で、VM で動くセッションと並んで表示されます。Mac から開始し、様子を見て、チャットし、作業を委任できます。Sidecar の通知領域アイコンから、PC 自体でセッションを開始することもできます。

PC と Mac は bromure.io を介してピアツーピアで 通信します。PC は外向きの接続しか行わないため、ポート転送も VPN も、アドレスの入力も不要です。

メモ: Sidecar のエージェントは PC 上で直接動くため、マシンのネットワーク境界を通りません。Squelch、認証情報の注入、トレース、サンドボックスポリシーは マシン(Linux VM)の機能であり、ネイティブマシンには適用されません。Sidecar のエージェントはあなたの Windows アカウントと同じアクセス権を持つので、それに応じて承認レベルを選んでください(承認レベルを参照)。

この章では、Sidecar のインストール、サインインと接続、エージェントのインストール、セッション、設定、アップデート、アンインストール、コマンドライン、トラブルシューティングを扱います。リモートアクセスの Mac 側については、リモートアクセスとクライアントを参照してください。

動作要件

WindowsWindows 10 バージョン 1809 以降、または Windows 11。64 ビット、Intel/AMD(x64)または ARM(ARM64)。
Git for Windows必須:エージェントと Bromure Agentic Coding のコマンドは Git Bash の下で動きます。ない場合はインストーラーがインストールを提案します。
Microsoft Edge WebView2 RuntimeSidecar のウィンドウに必須です。Windows 11 には組み込まれています。ない場合はインストーラーが提案します。
アカウントbromure.io アカウント。Mac の Bromure Agentic Coding がサインインしているものです。
管理者権限不要です。すべてあなた自身のアカウントにインストールされます。

Windows 11 バージョン 22H2 以降では、Sidecar のウィンドウは Windows 11 の半透明スタイルになります。それより古いバージョンでは見た目は簡素ですが、動作は同じです。

インストール

PC に合ったインストーラーをダウンロードします:

PCダウンロード
Intel または AMD(ほとんどの PC)BromureSidecar-x64.exe
ARM(たとえば Snapdragon 搭載ノート PC)BromureSidecar-arm64.exe

これらのリンクは常に最新バージョンを指しています。どちらが必要かわからない場合は、設定 → システム → バージョン情報 を開き、システムの種類 を見てください。「x64 ベース プロセッサ」なら x64、「ARM ベース プロセッサ」なら ARM64 です。ARM64 のインストーラーは x64 PC では実行を拒否し、その旨を表示します。

インストーラーを実行します。Seclio LLC の署名があるため、Windows には発行元としてその名前が表示されます。続いて:

  1. Git for Windows または WebView2 Runtime がない場合、インストーラーはそれらをコンポーネントとして表示します。チェックを入れたままにすると一緒にインストールされます。Git は winget から、WebView2 は Microsoft から取得します。両方ともすでにある場合、このページは飛ばされます。
  2. インストーラーは Bromure Sidecar を %LOCALAPPDATA%\Programs\Bromure Sidecar にコピーします。
  3. 最後のページでは Start Bromure Sidecar にチェックを入れたままにします。

インストーラーはさらに:

  • スタートメニューに Bromure Sidecar のショートカットを追加します。
  • Windows へのサインイン時に Sidecar が起動するようにします。
  • bromure.io がサインインを PC に戻すために使う bromure-agent-host:// リンクの種類を登録します。
  • アンインストール用に、設定 → アプリ → インストールされているアプリ に項目を追加します。

通知領域のアイコンとフライアウト

Bromure Sidecar はタスクバーの通知領域にいます。アイコンが見えない場合は ^ の矢印をクリックしてください。アイコンをタスクバーにドラッグすると、常に表示しておけます。

アイコンで状態がひと目でわかります:

アイコン意味
グレーSidecar が動いていないか、PC がどの Bromure Agentic Coding にも接続されていません。
カラー接続済み。ポインターを重ねると、接続先の Mac の名前が表示されます。
点付きエージェントがあなたを必要としています。返答か承認を待っています。

アイコンを 左クリック すると、Sidecar のパネルである フライアウト が開きます。ほかの場所をクリックするか Esc を押すと閉じます。右クリック すると、Open Bromure Sidecar、Coding Agents…、Quit Bromure Sidecar のメニューが開きます。

フライアウトには、上から順に次のものが表示されます:

  • ヘッダー:「Bromure Sidecar」と状態の行(「Not signed in to bromure.io」、「Signed in as pc-name」、「Attached to Mac as pc-name」など)。2 つのボタンで Coding agents と Settings を開きます。
  • バナー(該当する場合):Install ボタン付きの「Git for Windows is needed」、または Update ボタン付きの「Bromure Sidecar version is available」。
  • 接続カード:サインイン、または Mac への接続。
  • Sessions:この PC で動いているエージェント。
  • フッター:Coding Agents と Quit。

bromure.io へのサインイン

フライアウトの接続カードには Reach this PC from Bromure AC と表示されます。

  1. Sign in to bromure.io をクリックします。ブラウザーで bromure.io のサインインページが開きます。
  2. Mac が使っているアカウントでサインインし、この PC の追加を承認します。
  3. bromure.io は bromure-agent-host:// リンクでサインインを Sidecar に戻します。ブラウザーが Bromure Sidecar を開くかどうか尋ねることがあります。許可してください。

状態の行が「Signing in…」になり、続いて「Signed in as pc-name」になります。

ブラウザーが Sidecar を開けない場合(たとえば別のコンピューターでサインインを済ませた場合)は、ページから bromure-agent-host:// リンクをコピーし、フライアウトで Paste link をクリックします。

セキュリティ: Sidecar は、自分で開始したサインインしか受け付けません。bromure-agent-host:// リンクは、ブラウザーから届いたものでも貼り付けたものでも、Sign in to bromure.io で始めたサインインのコードを含んでいなければなりません。それ以外は「that sign-in link wasn't started here — sign in again from the menu」で拒否されます。これにより、Web ページやメッセージがこの PC を他人のアカウントに紛れ込ませることを防ぎます。このメッセージが出たら、もう一度 Sign in to bromure.io をクリックし、そのサインインを最後まで済ませてください。

マシン名は、Bromure Agentic Coding がこの PC を一覧に表示するときの名前です。既定ではコンピューター名の後ろに -native が付きます。設定で変更できます。

Bromure Agentic Coding への接続

サインインすると、接続カードに アカウントのサーバー が一覧表示されます。Bromure Agentic Coding がオンラインになっている Mac で、それぞれに Online または Offline と Attach ボタンが付いています。何も表示されない場合は「No Bromure AC server is online in your account」と出ます。Mac で Bromure Agentic Coding を開いてください(同じアカウントにサインインし、bromure.io 経由のリモートアクセスをオンにした状態で。リモートアクセスとクライアントを参照)。

Mac の横の Attach をクリックします:

  1. カードに Connecting と表示されます。
  2. 初回は Waiting for approval と表示されます:「Allow this PC in Bromure AC's fleet dialog on Mac.」Mac で Bromure Agentic Coding に尋ねられたら、PC を承認します。
  3. カードに Attached と表示され、通知領域のアイコンがグレーからカラーに変わります。

これで PC は Mac のマシンの中の Native Machines に表示されます。接続は再起動後も保たれ、Sidecar は次に起動したとき自動で再接続します。やめるには Detach をクリックします。その後 Mac は、もう一度接続するまでこの PC を忘れます。

接続に失敗すると、カードに理由が表示されます:

  • 「Can't reach Mac」— Mac がオフラインか、到達できません。
  • 「Mac didn't accept this machine (is it up to date?)」— Mac の Bromure Agentic Coding をアップデートしてください。
  • 「Mac refused this machine」— Mac で PC が拒否されました。Sidecar は 2 分後に再試行します。

コーディングエージェント

Sidecar にはエージェントが付属していません。Coding Agents(フライアウトのボタン、または通知領域メニューの Coding Agents…)を開き、この PC で動かすものを選びます:

エージェント提供元備考
Claude CodeAnthropic完全に統合:Bromure Agentic Coding でのライブ状態表示、チャット、委任。
CodexOpenAI
Grok BuildxAI
Kimi CodeMoonshot AI
Oh My Piオープンソース

各カードには、エージェントの状態(Installed · version、Not installed、Installing、Queued、Failed)と、そのインストーラーが実行する正確なコマンドがコピーボタン付きで表示されます。

  • Install / Update は、提供元からダウンロードしたエージェント自身のインストーラーを、管理者権限なしにあなたのアカウントで実行します。Bromure はどれも同梱もホストもしません。インストールは 1 つずつ行われます。ほとんどのエージェントは、その後は自分で最新の状態を保ちます。
  • Sign in… は、エージェントをそのプロバイダーにサインインさせます。Sidecar は Copy と Open sign-in page 付きでワンタイムコードを表示します。Claude Code の場合は、ページに表示されたコードを貼り付けて Submit をクリックします。「Agent: signed in」と出れば完了です。(Oh My Pi にはここでのサインイン手順はありません。)
  • Check again は、インストールされているものを再確認します。たとえば、自分でエージェントをインストールしたあとに使います。

承認レベル

各エージェントのカードには承認の設定があります。新しいセッションと再開したセッションに適用されます:

レベルエージェントの動作
Ask行動する前に尋ねます。エージェント自身の既定です。
Auto危険な操作のときだけ尋ねます。Codex の場合:一切尋ねませんが、Codex 自身のサンドボックスは保ちます。Kimi Code の場合:必要なときだけ尋ねます。
Full一切尋ねず、制限もありません。

Oh My Pi で選べるのは Ask と Full だけです。

警告: Sidecar では、Full はエージェントがあなたの Windows アカウントにできることを何でも、尋ねずに実行できることを意味します。PC をエージェント専用にしているのでない限り、Ask か Auto を選んでください。

セッション

フライアウトの Sessions の一覧には、この PC で動いているすべてのエージェント(Mac から開始したものも PC から開始したものも)が、タイトル、エージェント、フォルダー、状態(Working、Needs you、Idle)とともに表示されます。単なるターミナルは Shell と表示されます。

  • セッションをクリック すると、ターミナルウィンドウ(インストールされていれば Windows Terminal)で開きます。ターミナルウィンドウはいつ閉じてもかまいません。セッションは動き続けます。
  • New は PC でセッションを開始します。インストール済みのエージェントを選び、作業させるフォルダーを選んで Start in this folder をクリックします。そのフォルダーでターミナルが開き、セッションは Mac の Bromure Agentic Coding にも表示されます。
  • End this session(行にポインターを重ねると現れる電源ボタン)でセッションを終了します。

Mac からは、Sidecar マシンはほかのマシンと同じように使えます。セッションを開始し、ターミナルを開き、Claude Code のセッションとチャットし、作業を委任できます。パスは Linux 式に表示されます。Windows のプロファイルフォルダーは /home/ubuntu、D:\src は /d/src です。

エージェントは Sidecar より長生きします。 エージェントは別のバックグラウンドプロセスで動くため、Bromure Sidecar を終了しても、アップデートをインストールしても止まりません。ただし Sidecar を終了している間は、Mac からエージェントに到達できません。エージェントが動いている状態で終了しようとすると警告が出ます。Windows の再起動、Windows からのサインアウト、アンインストールでは、エージェントは止まります。

設定

フライアウトのヘッダーから Settings を開きます:

  • Start at login — Windows へのサインイン時に Sidecar を起動し、再起動後もエージェントに到達できるようにします。既定ではオンです。
  • Machine name — Bromure Agentic Coding がこの PC を一覧に表示するときの名前です。空にすると既定(コンピューター名-native)に戻ります。
  • SSH host key — この PC の SSH ホストキーのフィンガープリントで、Mac から確認できるようコピーボタンが付いています。
  • bromure.io account — PC がどのアカウントでサインインしているかと、Sign out。サインアウトすると PC の接続も解除され、アカウントのキーが PC から削除されます。

フッターには Sidecar のバージョンと SSH サーバーのアドレスが表示されます(セキュリティを参照)。

アップデート

Sidecar は起動の 2 分後に新しいバージョンを確認し、その後は 12 時間ごとに確認します。新しいバージョンがあると、フライアウトに「Bromure Sidecar version is available — Agents keep running while it installs.」と表示されます。Update をクリックすると、Sidecar は新しいインストーラーをダウンロードして検証し、サイレントでインストールします。Sidecar は数秒後に自動で再起動し、動いているエージェントは中断されません。

Update をクリックしない限り、何もアップデートされません。ダウンロードリンクから最新のインストーラーを既存のものの上から実行すれば、いつでも新しいバージョンをインストールすることもできます。

アンインストール

設定 → アプリ → インストールされているアプリ を開き、Bromure Sidecar を見つけて アンインストール を選びます。エージェントがまだ動いている場合、アンインストーラーはまず「Agents are still running in Bromure Sidecar. Uninstalling stops them. Continue?」と尋ねます。

アンインストールでは、プログラム、スタートメニューのショートカット、サインイン時の自動起動の項目、bromure-agent-host:// リンクの種類が削除されます。データフォルダー %LOCALAPPDATA%\BromureSidecar(サインイン、設定、ログ)は残ります。まっさらな状態にしたい場合は、このフォルダーも削除してください。PC を bromure.io アカウントからも外すには、アンインストールの前に(設定で)サインアウトしてください。

セキュリティ

  • 外向きの接続のみ。 PC はネットワークに対してポートを開きません。SSH サーバーは 127.0.0.1(ポート 2223)でのみ待ち受け、Mac は PC 自身が接続する bromure.io のリレーを通じて到達します。
  • パスワードではなくキー。 SSH ログインはキーのみで、あなた自身の Windows ユーザー名に限られます。キーは bromure.io アカウントのデバイスから取得され、Sidecar が 3 分ごとに同期し、サインアウト時に削除します。
  • Mac での承認。 Mac は、そこであなたが承認したあとでなければ Sidecar の接続を許しません。
  • データはあなたのもの。 Sidecar のフォルダーを読めるのは、あなたのアカウントと Windows 自身だけです。
  • 署名済みソフトウェア。 インストーラーとその中のすべてのプログラムは Seclio LLC の署名とタイムスタンプ付きです。アップデートは実行前に、公開された SHA-256 と照合されます。
  • ネットワーク境界なし。 冒頭で述べたとおり、ネイティブマシンには Linux VM のゲートウェイによる保護がありません。Sidecar は自分のターミナルと同じように扱い、それに応じてエージェントの承認レベルを選んでください。

コマンドライン

インストールフォルダーにある bromure-sidecar.exe は、Sidecar のコマンドラインツールです。その ctl コマンドは、実行中の Sidecar とやりとりします:

コマンド動作
bromure-sidecar ctl healthSidecar が動いているか。
bromure-sidecar ctl statusバージョン、マシン名、アカウント、接続、SSH のポートとフィンガープリント、実行中のエージェント。
bromure-sidecar ctl signinbromure.io のサインインページを開きます。
bromure-sidecar ctl enroll <code-or-link>コピーしたコードまたはリンクでサインインします(Paste link と同じ)。
bromure-sidecar ctl signoutbromure.io からサインアウトします(接続も解除)。
bromure-sidecar ctl serversアカウントのサーバーを一覧表示します。
bromure-sidecar ctl attach {"id":"<server-id>"}サーバーに接続します。
bromure-sidecar ctl detach接続を解除します。
bromure-sidecar ctl machine-name <name>PC の名前を変更します。
bromure-sidecar ctl install-stateエージェントのインストール状態。
bromure-sidecar ctl quitSidecar を終了します(エージェントは動き続けます)。
bromure-sidecar claude現在のフォルダーで Claude Code を Sidecar のセッションとして開始し、ここでそれに接続します。動かしたまま離れるには Ctrl-B、続けて D を押します。
bromure-sidecar versionバージョンを表示します。

PowerShell では、JSON の引数を単一引用符で囲みます:bromure-sidecar ctl attach '{"id":"<server-id>"}'。

ファイルとフォルダー

パス内容
%LOCALAPPDATA%\Programs\Bromure Sidecarプログラム。
%LOCALAPPDATA%\BromureSidecarあなたのデータ:サインイン、設定、セッション、SSH キー。
%LOCALAPPDATA%\BromureSidecar\settings.json設定。ボタンのないものも含みます:sshPort(既定は 2223)と updateFeed("" にするとアップデートの確認をオフにします)。編集したら Sidecar を終了して起動し直してください。
%LOCALAPPDATA%\BromureSidecar\logs\bromure-sidecar.logログ。

トラブルシューティング

問題対処
「Bromure Sidecar isn't running」スタートメニューから Bromure Sidecar を起動します。エージェントは止まっていません。
「Git for Windows is needed」のバナーが出る、またはコマンドが「Git for Windows isn't installed on this machine」で失敗するバナーの Install をクリックする(winget install --id Git.Git -e --scope user を実行します)か、自分で Git for Windows をインストールしてから、やり直します。
「WebView2 isn't available」Microsoft Edge WebView2 Runtime をインストールしてから、Sidecar をもう一度起動します。
「that sign-in link wasn't started here — sign in again from the menu」Sign in to bromure.io をクリックし、そのサインインを最後まで済ませます。bromure.io へのサインインを参照してください。
「This machine was removed from your bromure.io account.」PC が bromure.io 上で削除されました。もう一度サインインします。
「Enrolled without the agent-host capability…」Settings でサインアウトし、Sign in to bromure.io でもう一度サインインします。
「No Bromure AC server is online in your account.」同じアカウントにサインインし、bromure.io 経由のリモートアクセスをオンにした状態で、Mac の Bromure Agentic Coding を起動します。
Waiting for approval のまま進まないMac の Bromure Agentic Coding で PC を承認します。
エージェントがインストールされていないと言うCoding Agents からインストールします。インストーラーが完了したのにエージェントが見つからない場合は、Check again をクリックするか、Windows からサインアウトしてサインインし直します。
Settings の画面に「Couldn't start the SSH server」と表示される別のプログラムがポート 2223 を使っています。settings.json で別の sshPort を設定し、Sidecar を終了して起動し直します。
それ以外通知領域メニューから Sidecar を終了して起動し直し(エージェントは動き続けます)、ログファイルを確認します。bromure-sidecar ctl status で Sidecar の状態をまとめて確認できます。