インストール

この章では、まっさらな Mac から Bromure Agentic Coding が完全にインストールされた状態までを案内します。アプリがマシンに求めるもの、リリースをダウンロードしてインストールする方法、初めて起動したときに何が起こるか、Linux ベースイメージがどのようにダウンロード・検証され、最新の状態に保たれるか、そしてすべてをきれいに削除する方法を扱います。インストールが完了したら、クイックスタートに進んで最初のワークスペースを作成してください。

システム要件

Intel 版は存在せず、今後も提供されません。アプリは Apple の Virtualization.framework 上で Linux 仮想マシン（VM）を実行しますが、これは Apple Silicon ホスト上の ARM64 ゲストのみをサポートするためです。

ディスク容量に関する 2 つのセーフガードが組み込まれています。

• すべてのイメージインストールは、まずアプリのサポートディレクトリを含むボリュームに最低 8 GB の空きがあるかを確認し、そうでなければ明確なメッセージとともに直ちに失敗します。
• ローカルイメージビルド中は、空き容量が 1 GB を下回るとモニターが明示的なディスク不足エラーでビルドを中止し、インストーラーが原因不明のままタイムアウトすることを防ぎます。

ワークスペース内でオプションの組み込みウェブブラウザを使う予定があるなら、その別途の Alpine/Chromium イメージ（ダウンロードは圧縮で約 500 MB）用に追加容量を見込んでください。そのインストールについては 設定 → ブラウザ で扱います。

リリースビルドのインストール

リリースビルドは、bromure.io にて署名・公証済みのディスクイメージ（BromureAgenticCoding.dmg）として公開されます。

1. bromure.io のダウンロードページから DMG をダウンロードします。
2. DMG を開きます。ウィンドウにはアプリアイコンと、アプリケーション シンボリックリンクを指す矢印が表示されます。
3. Bromure Agentic Coding を アプリケーション シンボリックリンクにドラッグします。
4. DMG を取り出し、/Applications からアプリを起動します。

公開されている DMG は公証・ステープルされているため、Gatekeeper は警告なしに開きます。bromure.io 以外のどこかから DMG を入手して Gatekeeper が文句を言う場合は、回避すべきものではなく危険信号として扱ってください。

初回起動

ウェルカムウィンドウ

Linux ベースイメージが Mac 上に存在するまで、アプリはエージェントワークスペースを実行できません。初めて起動したとき（ベースイメージがまだない状態）、アプリはワークスペースブラウザの代わりにウェルカムウィンドウを開きます。

このウィンドウ（タイトルは Bromure Agentic Coding）には、アプリアイコン、Bromure Agentic Coding へようこそ という見出し、短い説明（「初回セットアップでは、ビルド済みの Ubuntu 24.04 イメージをダウンロード（ダウンロードが利用できない場合はローカルでビルド）し、分離された VM 内に Node.js、Claude Code、Codex、ターミナルツールをインストールします。これはベースイメージのバージョンごとに一度だけ行われます。」）、そして目立つ はじめる ボタンが表示されます。

はじめる をクリック（または Return を押す。これがデフォルトボタンです）して開始します。これは bromure-cli init CLI コマンドとまったく同じインストールを実行します。

メモ: ウェルカムテキストでは Node.js、Claude Code、Codex を例として挙げています。完全に言えば、Node.js と無償ツールはすでにビルド済みイメージに組み込まれており、セットアップでは追加で Grok CLI と Google Cloud SDK をインストールします。後述の 初回セットアップが行うこと を参照してください。

アプリがリモートミラーリングクライアントとしてのみ（リモートアクセス を参照）、またはウィンドウを持たない ヘッドレスエージェント として起動された場合、いずれもローカルのベースイメージを必要としないため、ウェルカムウィンドウはスキップされます。

セットアップ進捗ウィンドウ

はじめる の後、ウィンドウは Bromure Agentic Coding — Setup というタイトルの進捗画面に切り替わり、「Building base image」／「This is the one-time install. Don't close the window.」という見出しが表示されます。ここには次のものが表示されます。

• 現在のステップを示すステータスピル。ダウンロード経路の場合は「Fetching image catalog…」「Downloading Ubuntu 24.04 image (… GB)…」「Verifying checksum…」「Expanding image…」「Installing recommended packages (N step(s), ~2-5 min)…」、そして最後に「Base image ready at … (vNNN)」。
• 数値パーセンテージ付きの単一の確定的な進捗バー。ダウンロード経路ではバーはフェーズごとに重み付けされます。イメージのダウンロードが 0～60%、展開が 60～80%、そしてポストインストールのステップが残りを埋めます。
• デフォルトで折りたたまれている Console output の開示ビュー。生のインストーラーログ（ヘルパー VM のシリアルコンソール）をストリーミングします。テキストは選択可能で、コピーアイコンボタンでログ全体をクリップボードにコピーできます。画面上には最後の 100 行のみが保持されます。

何かが失敗すると、ステータスピルは赤いエラー行に置き換えられ、Close ボタンが表示されます。

インストールの途中でウィンドウを閉じようとすると警告が表示されます。Cancel base-image rebuild?（「The image will be left in an incomplete state. You'll need to re-run the rebuild before launching new sessions.」）で、Cancel rebuild と Keep building のボタンがあります。キャンセルして以前の動作するイメージが存在する場合、アプリは通常のメインウィンドウに戻ります。存在しない場合はウェルカム画面に戻ります。

メモ: イメージのインストールまたは修正が実行されている間、オプションの SSH リモートアクセスの入り口は一時停止され、その後自動的に再開されます（リモートアクセス を参照）。

bromure-cli プロンプト

インストール済みアプリバンドルから初めて GUI を起動すると、アプリはコマンドラインのエントリーポイントのインストールを提案します。Install the "bromure-cli" command-line tool? —「This creates a symlink at /usr/local/bin/bromure-cli so you can drive Bromure from the terminal (vm, exec, trace, …). It needs your admin password once.」

• Install は、一度限りの管理者パスワードプロンプトを介して /usr/local/bin/bromure-cli にシンボリックリンクを作成します（特権ヘルパーはインストールされません）。
• Not Now は延期します。次回起動時に再度尋ねられます。
• Don't Ask Again はプロンプトを永久に抑制します（cliSymlinkDeclined の UserDefaults キーに保存されます）。

バイナリが bromure-cli という名前で呼び出されると、イメージ管理コマンド（init、info、reset、およびパブリッシャー側の動詞）、GUI デフォルト、および MCP サーバーは非表示になります。bromure-cli を引数なしで実行するとヘルプが表示されます。完全なコマンドリファレンスは 自動化と CLI にあります。このプロンプトは、ヘッドレスエージェント、開発（swift run）、およびリモートミラーリングの起動ではスキップされます。

初回セットアップが行うこと

初回セットアップはベースイメージを生成します。これは EFI/GRUB ブートを備えた Ubuntu 24.04（「noble」）を含む 24 GB のスパースディスクで、すべてのワークスペース VM はここからクローンされます。これを生成する経路は 2 つあり、ダウンロードが優先され、ローカルビルドがフォールバックです。どちらも .partial ファイルに書き込み、結果をアトミックに昇格させるため、中断されたインストールが動作するイメージの代わりに半分書き込まれたイメージを残すことはありません。

ビルド済みイメージのダウンロード

優先される経路では、https://dl.bromure.io に毎週公開されるビルド済みイメージをダウンロードします。

1. カタログの取得。 アプリは https://dl.bromure.io/images/img-catalog.json にある署名付きのイメージカタログを取得します。これは現在のイメージ（UUID、バージョン、SHA-256、サイズ）を指定し、ポストインストールのステップを列挙します。カタログには、アプリの更新に署名するのと同じ鍵（Sparkle の SUPublicEDKey）で作成された ed25519 署名が付いています。署名はイメージの識別情報、そのチェックサム、そしてすべてのポストインストールコマンドを対象とします。署名のない、または無効なカタログは拒否され、アプリがすでに採用したものより古く署名されたカタログは決して受け入れられません（ロールバック保護）。
2. ダウンロード。 gzip 圧縮されたイメージ（圧縮で約 3 GB）がダウンロードされ、その SHA-256 が検証されます。失敗したダウンロードは最大 3 回リトライされ、試行の間にカタログを再取得します。これにより、毎週の公開が前のビルドをダウンロードの途中で削除する競合状態を防ぎます。
3. 展開。 イメージは base.img.partial にスパースに展開されます。論理サイズは 24 GB ですが、物理ディスク容量は約 6～8 GB のみです。
4. ポストインストール。 アプリは小さな Alpine ネットブートインストーラーヘルパー VM を起動し、カタログのポストインストールステップをイメージ上の chroot 内で root として実行します（次のセクションを参照）。
5. 昇格。 新しい EFI 変数ストアが作成され、base.img、efivars.bin、base.version、image-state.json がアトミックに昇格されます。

ポストインストールステップ: 推奨パッケージ

公開されるイメージは法的に再配布可能でなければならないため、厳密に自由なソフトウェアのみを含みます（Node.js、docker、kitty、gh、glab、kubectl、doctl、awscli、azure-cli などが組み込まれています）。非自由なものはすべて、カタログ内で署名付きのポストインストールステップとして宣言され、あなたのマシン上で、あなたのイメージのコピーにインストールされます。バージョン 4.3.0 のベースラインステップは次のとおりです。

同意は次のように機能します。新規インストールでは、すべてのベースラインステップが追加のプロンプトなしで実行されます。ウェルカム画面からセットアップを開始すること（または bromure-cli init と入力すること）が同意にあたります。後から公開されたステップは、ベースイメージの更新とバージョン管理 で説明する New recommended packages プロンプトを通じて明示的な承認が必要です。カタログ署名がすべてのステップのコマンドテキストを対象とするため、侵害された CDN があなたのイメージ内で root として実行される内容を改変することはできません。

ローカルビルドのフォールバック

ダウンロード側の理由（オフライン、CDN の障害、チェックサムまたは展開の失敗）でダウンロードが失敗すると、アプリは Image download failed アラートを Build Locally と Cancel のボタンとともに表示します。決して黙ってフォールバックすることはありません。（対照的に、bromure-cli init CLI コマンドはプロンプトなしで自動的にフォールバックします。）

ローカルビルドは、あなた自身の Mac 上で同じイメージを生成します。

1. Alpine 3.22 のネットブートカーネルと initramfs（約 25 MB、サポートディレクトリにキャッシュ）をダウンロードします。
2. 新しい 24 GB のスパースディスクを割り当てます。
3. ワンショットの Alpine インストーラー VM（4 vCPU、4 GB RAM）を起動し、そのシリアルコンソール経由で駆動して、Ubuntu noble を debootstrap し、無償ツールと GRUB をインストールします。
4. ダウンロード経路と同じカタログのポストインストールステップを適用します。

進捗メッセージには「Downloading Alpine netboot installer…」「Allocating 24GB sparse disk…」「Booting Alpine installer (this drives the Ubuntu install)…」「Running setup.sh…」が含まれます。この経路の進捗バーはインストーラーのログ行によって駆動され、最後の「Base image ready」のジャンプまで 97% で頭打ちになります。

ローカルビルドには VPN 耐性の仕組みが含まれます。すべてのゲストパッケージ取得はインプロセスのホスト側プロキシを経由し、インストーラーはダウンロード前に VM の NIC の MTU を制限し、DHCP には 2 回目のチャンスが与えられ、ネットワークなしの状態は早期に中止され、ゲストのカーネルパニックは 1 回の自動的なクリーンリトライを引き起こします。関連する 2 つのエスケープハッチがあります。

• インストーラー VM が DHCP リースを取得できない場合、ビルドは Network Issue During Base-Image Build アラートとともに失敗し、Repair and Retry（macOS のネットワークデーモンを再起動。管理者パスワードを求めます）または Cancel を提供します。
• 大きな転送をブラックホール化する VPN（例: MTU 1420 の WireGuard）では、インストーラー VM の MTU を固定できます。defaults write io.bromure.agentic-coding vm.mtu -int 1400。

いつでも明示的にローカルビルドを選択することもできます。アプリメニューの Rebuild Base Image… → Rebuild Locally、または bromure-cli init --build-local です。

セットアップ中に使用されるネットワークエンドポイント

ファイアウォールおよびプロキシの管理者向けに、インストールが通信する先は次のとおりです。

インストール自体はリッスンする TCP ポートを開きません。ビルド中に使用されるホスト側パッケージプロキシは、ビルドごとに localhost 限定のエフェメラルポートをバインドします。

セットアップ時間とディスク使用量

ディスク使用量:

• 開始時: ~/Library/Application Support/BromureAC/ を含むボリュームに最低 8 GB の空き。
• インストール後: ベースイメージは物理的におよそ 6～8 GB を占有します（論理 24 GB。スパースブロックは書き込まれたときにのみ容量を消費します）。
• ワークスペースごと: 各ワークスペースのディスクは、ベースイメージの APFS コピーオンライトクローンとして始まるため、当初はほぼ無償であり、ワークスペースがデータを書き込むにつれてのみ成長します。

セットアップはベースイメージのバージョンごとに一度だけ行われます。以降の起動では直接ワークスペースブラウザに進みます。

すべてが保存される場所

アプリが書き込むすべてのものは、あなたのユーザーアカウントの下に存在します。オプションの bromure-cli シンボリックリンクを除き、システム全体にインストールされるものはありません。

必要上、他の場所に存在する 2 つの項目があります。

• 認証情報のマスターキーは、サポートディレクトリではなく macOS のデータ保護キーチェーンに保存されます（このデバイスのみ とマークされ、Mac から出ることはありません）。ディスク上のシークレットは AES-256-GCM 暗号文です。認証情報 を参照してください。
• アプリバンドルには、リモートミラーリングのネットワークヘルパーが使用する特権 launchd デーモン plist（io.bromure.fatclient-tunnel）が埋め込まれています。これはオンデマンドで登録され、最初の登録時にシステム設定 › 一般 › ログイン項目に承認トグルが表示されます。リモートアクセス を参照してください。

bromure-cli info コマンドは、インストール済みイメージのバージョンスタンプ、その論理サイズと物理サイズ、そしてそのパスをいつでも表示します。

ベースイメージの更新とバージョン管理

バージョンスタンプとドットリビジョン

インストール済みイメージは、そのバージョンを base.version に記録します。メジャー部分はアプリにバンドルされたバージョン定数（バージョン 4.3.0 では 200）に由来します。同じメジャーでのリビルド、再ダウンロード、または修正はドットリビジョンを追加します（200 → 200.1 → 200.2）。サイドカーの image-state.json は、イメージの出所と、どのポストインストールステップの UUID が適用されたかを記録します。

これらのスタンプを使う 2 つの比較があります。

• アプリレベルの更新チェックはメジャーのみを比較するため、意図的なイメージリリースについてのみ通知されます。
• ワークスペースごとのドリフト検出は、ワークスペースがクローンされたときに記録された完全なスタンプを現在のものと比較します。変更（ドットリビジョンを含む）があると、ワークスペースは新しいベースへのリセットを提案します。イメージ更新がそれ自体で既存のワークスペースディスクに触れることは決してありません。ドリフトのリセットは常にあなたの判断次第です（ワークスペース を参照）。

ビルド済みイメージは新しい Ubuntu パッケージとともに毎週再公開されますが、毎週の再公開はバージョンを上げません。アプリリリースでの意図的なバージョンアップのみが更新プロンプトをトリガーするため、毎週催促されることはありません。古い CDN カタログがダウングレードを提案することは決してありません。厳密に新しいバージョンのみがカウントされます。

更新プロンプト

より新しいメジャーイメージバージョンが利用可能なとき（アプリ更新がそれをバンドルしているか、カタログがそれを公開しているかのいずれか）、起動時にノンブロッキングのアラート Base image update available が表示されます。「Your base image is at version X but version Y is available. The current image still works — updating downloads the new prebuilt image (a few GB; local rebuild as fallback) and re-applies the recommended packages.」

• Update Now は、セットアップウィンドウでダウンロード優先の再インストールを開始します。
• Later はこの起動に限って却下します。次回起動時に再度尋ねられます。既存のイメージはどちらの場合でも動作し続けます。

新しい推奨パッケージ

カタログが image-state.json にまだ適用済みとして記録されていないポストインストールステップを取得すると、起動時に同意アラート New recommended packages が表示され、新しいステップが列挙されます。「New packages are recommended to be installed: … Bromure installs them into the base image (a few minutes, in the background VM). Existing workspaces keep running; each one's drift prompt will offer a reset to pick them up.」

• Install は、base.img の APFS コピーオンライトクローンにステップを適用し、修正されたイメージをアトミックにスワップインします。既存のワークスペースは全体を通じて動作し続けます。バージョンスタンプにはドットリビジョンのアップが付きます（例: 200 → 200.1）。進捗はセットアップウィンドウに「Installing recommended packages」／「The base image is being amended. Existing workspaces keep working.」というタイトルで表示されます。
• Later は延期します。次回起動時に再度尋ねられます。

この同意なしに何かが実行されることは決してありません。ポストインストールステップはベースイメージ内で root として実行されます。image-state.json より前のインストールは起動時に移行されます。バンドルされたすべてのベースラインステップが適用済みとしてマークされます。

手動リビルド

いつでも再インストールを強制するには、アプリケーションメニュー（Remote Access… の下）から Rebuild Base Image… を選択します。Update the base image? —「Downloads the latest prebuilt image (or re-runs the full local installer, ~5–10 min) and re-applies the recommended packages. Existing workspaces' disks aren't touched — on next launch each one's drift prompt will offer to reset to the new base.」と尋ね、Download Prebuilt、Rebuild Locally、Cancel が表示されます。

新しいイメージが完全にビルドされるまで古いイメージは稼働し続けるため（.partial ファイルとアトミックスワップのおかげ）、リビルド中もセッションを起動できます。CLI での同等の操作は bromure-cli init（ダウンロード優先）または bromure-cli init --build-local です。

アプリを最新の状態に保つ

アプリは Sparkle を使って自身を更新します。1 日に一度、自動的に https://bromure.io/api/v1/release-agentic-coding をチェックし、更新はイメージカタログに署名するのと同じピン留めされた公開鍵に対して検証されます。手動の Check for Updates… 項目がアプリケーションメニューの About のすぐ下にあります。（この項目は、アップデーターが初期化されない開発ビルドには存在しません。）

アプリ更新とベースイメージ更新は独立しています。アプリの更新は、新しいアプリバージョンがバンドルされたイメージバージョンを意図的に上げた場合にのみイメージ更新を促します。

新しい Mac への移行

組み込みの移行アシスタントはありません。推奨される手順は、新規インストールとワークスペースデータの選択的なコピーです。

1. 新しい Mac でアプリをインストールし、初回セットアップを完了します（ベースイメージの再ダウンロードは、コピーするよりも速くクリーンです。base.img と efivars.bin は、アプリが無償で再作成するマシンごとのアーティファクトです）。
2. 両方の Mac でアプリを終了します。
3. 古い Mac の ~/Library/Application Support/BromureAC/profiles/ を、新しい Mac の同じ場所にコピーします。各サブディレクトリは 1 つのワークスペースです。その定義（profile.json）、その VM ディスク（disk.img — クローンされたリポジトリ、キャッシュ、シェル履歴）、そのホームボリューム、そして SSH キー。
4. 新しい Mac でアプリを起動します。ワークスペースがワークスペースブラウザに表示されます。ワークスペースが、現在インストールされているものとは異なるベースイメージリビジョンからクローンされていた場合、そのドリフトプロンプトがリセットを提案します。ワークスペースの現在のディスクを保持するには拒否してください（ワークスペース を参照）。

意図的に転送されない 3 つのものがあります。

• 認証情報。 保存されたシークレットを暗号化するマスターキーは、Mac のデータ保護キーチェーンに存在し、このデバイスのみ とマークされています。古い Mac からの暗号化されたシークレットブロブは新しい Mac では読み取れません。各 profile.json 内の機密でないメタデータは残るため、認証情報ペインで API キーとトークンを再入力するだけで済みます（認証情報 を参照）。
• エンタープライズ登録。 インストール識別情報（mTLS リーフ証明書）はインストールごとのもので、デバイス限定で保存されます。新しい Mac を再登録してください（エンタープライズ を参照）。
• アプリ設定（io.bromure.agentic-coding の defaults ドメイン内）。自分で移行しない限り。

ヒント: ワークスペースの disk.img ファイルはスパースであり、そのコピーオンライトの節約はネットワークコピーでは維持されません。古い Mac で数 GB のワークスペースが、転送中にはフルの書き込み済みサイズで実体化することがあります。スパース対応のコピー（例: rsync -aS）を使い、まず宛先の空き容量を確認してください。

Apple の移行アシスタントは、サポートディレクトリ全体を通常のファイルとしてコピーします。それは機能しますが、それでも上記の認証情報と登録の状況に陥り、コピーされたベースイメージはワークスペースディスクとのコピーオンライトの関係を失います（リビルドするまで余分な物理容量がかかります）。

完全にアンインストールする

アプリとワークスペースを保持したままベースイメージだけをリセットするには、bromure-cli reset を実行します（確認をスキップするには --yes を追加）。これは base.img、efivars.bin、base.version、image-state.json を削除するため、次回起動時にはセットアップが最初から始まります。ワークスペースに触れることは決してなく、キャッシュされた Alpine ネットブートファイルとキャッシュされたカタログはそのまま残します。

バンドルされたアンインストーラーはありません。完全な削除は手動です。

1. アプリを終了します（およびすべてのヘッドレスエージェント: pgrep -fl bromure-cli で確認）。

2. Bromure Agentic Coding を /Applications からゴミ箱にドラッグします。

3. サポートディレクトリを削除します。ベースイメージ、すべてのワークスペースとそのディスク、キャッシュ、そしてインストールごとの CA。

   rm -rf ~/Library/Application\ Support/BromureAC
   

4. ログイン時起動の LaunchAgent が存在する場合は削除します。

   rm -f ~/Library/LaunchAgents/io.bromure.agentic-coding.boot.plist
   

5. システム設定 › 一般 › ログイン項目と機能拡張から、アプリのエントリを削除します（有効にしたことがある場合のリモートミラーリングトンネルデーモンの承認トグル）。

6. CLI シンボリックリンクをインストールした場合は削除します。

   sudo rm -f /usr/local/bin/bromure-cli
   

7. 任意で、アプリの設定をクリアします。

   defaults delete io.bromure.agentic-coding
   

警告: ステップ 3 は、すべてのワークスペースのディスク（クローンされたリポジトリ、未コミットの作業、パッケージキャッシュ、シェル履歴）を永久に削除します。大切なものは先にプッシュまたはエクスポートしてください。

キーチェーン内の認証情報マスターキーは、その暗号文がなくなると孤立します。無害ですが、キーチェーンアクセスで io.bromure.agentic-coding.master-key を検索して削除できます。