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 側については、リモートアクセスとクライアントを参照してください。
動作要件
| Windows | Windows 10 バージョン 1809 以降、または Windows 11。64 ビット、Intel/AMD(x64)または ARM(ARM64)。 |
| Git for Windows | 必須:エージェントと Bromure Agentic Coding のコマンドは Git Bash の下で動きます。ない場合はインストーラーがインストールを提案します。 |
| Microsoft Edge WebView2 Runtime | Sidecar のウィンドウに必須です。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 には発行元としてその名前が表示されます。続いて:
- Git for Windows または WebView2 Runtime がない場合、インストーラーはそれらをコンポーネントとして表示します。チェックを入れたままにすると一緒にインストールされます。Git は winget から、WebView2 は Microsoft から取得します。両方ともすでにある場合、このページは飛ばされます。
- インストーラーは Bromure Sidecar を
%LOCALAPPDATA%\Programs\Bromure Sidecarにコピーします。 - 最後のページでは 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 と表示されます。
- Sign in to bromure.io をクリックします。ブラウザーで bromure.io のサインインページが開きます。
- Mac が使っているアカウントでサインインし、この PC の追加を承認します。
- 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 をクリックします:
- カードに Connecting と表示されます。
- 初回は Waiting for approval と表示されます:「Allow this PC in Bromure AC's fleet dialog on Mac.」Mac で Bromure Agentic Coding に尋ねられたら、PC を承認します。
- カードに 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 Code | Anthropic | 完全に統合:Bromure Agentic Coding でのライブ状態表示、チャット、委任。 |
| Codex | OpenAI | |
| Grok Build | xAI | |
| Kimi Code | Moonshot 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 health | Sidecar が動いているか。 |
bromure-sidecar ctl status | バージョン、マシン名、アカウント、接続、SSH のポートとフィンガープリント、実行中のエージェント。 |
bromure-sidecar ctl signin | bromure.io のサインインページを開きます。 |
bromure-sidecar ctl enroll <code-or-link> | コピーしたコードまたはリンクでサインインします(Paste link と同じ)。 |
bromure-sidecar ctl signout | bromure.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 quit | Sidecar を終了します(エージェントは動き続けます)。 |
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 の状態をまとめて確認できます。 |