付録 — ショートカット、ファイル、ポート、環境
この付録では、マニュアルのほかの部分に散らばっている具体的な事実を、参照用の表にまとめています: キーボードショートカット、ディスク上の場所、ネットワークポート、環境変数と既定値、そしてゲスト VM のチートシートです。ここに記載する内容はすべて出荷ビルド(バージョン 5.0.0、バンドル ID io.bromure.agentic-coding、アプリのバイナリ bromure-ac)に基づいています。これらを読み書きするコマンドについては CLI、API、MCP を、インストール時に作成されるものについてはインストールと初回起動を参照してください。
以下で使うプレースホルダー: <uuid> はマシン(ワークスペース)の識別子、<id> はクラスタ、レジストリ、実行の識別子、<version> は固定されたツールのバージョン、<org>--<name> はモデルのリポジトリ、<host-UUID> は保存済みのリモートホストです。
キーボードショートカット
ステージに何があるかで変わるショートカットには、その旨を記載しています。macOS の標準ショートカット(⌘Q、⌘H、⌘M、⌘C、⌘V など)は通常どおり使えます。
セッションとナビゲーション
| ショートカット | 操作 |
|---|---|
| ⌘N | 新規セッション… — 新規セッション画面。 |
| ⌘K | 移動… — コマンドパレット(セッション、ルーム、マシン、アクション、会話内のテキスト)。↑/↓ で移動、⏎ で開きます。 |
| ⌘1 – ⌘9 | セッションまたは新規セッション画面がステージにあるとき: サイドバーの 1〜9 番目のセッションへ移動。マシンのターミナルでは: そのタブに切り替え。⌘ を押し続けると、サイドバーに番号が表示されます。 |
| ⌥⌘↑ / ⌥⌘↓ | サイドバーの順で前 / 次のセッション。 |
| ⌘⏎ | ステージにある一時停止中または完了したセッションを再開します。新規セッション画面では 開始。 |
| ⌘W | セッションがステージにあるとき: セッションを終了(まず「「‹セッション›」を終了しますか?」と尋ね、その後 取り消す を提示します)。マシンのターミナルでは: タブを閉じます。 |
| ⌃⌘R | 次のルーム。 |
| ⌥⌘U | Linux — セッションからマシン上のそのターミナルタブへ移動し、また戻ります(そのときピルは セッション と表示されます)。 |
| ⌘Z | 通知が表示されている間に、直前の終了、アーカイブ、削除、移動を 取り消す。 |
| ⌃⌘S | サイドバーを折りたたむ / 展開する。 |
| ⌃⌘B | エージェント用ブラウザペインの表示 / 非表示。 |
| ⌃⌘E | ファイルパネルの表示 / 非表示。 |
| ⌘, | 環境設定… |
チャット内
| ショートカット | 操作 |
|---|---|
| ⏎ | メッセージを送信(新規セッション画面ではセッションを開始)。 |
| ⌥⏎ | 改行。 |
| Esc | 作業中のエージェントを 停止。 |
/ | スラッシュコマンドのパレットを開く(↑/↓ で移動、⇥ で補完、⏎ で選択、Esc で閉じる)。 |
@ | 依頼できるセッションのパレットを開く。 |
ルーム
| ショートカット | 操作 |
|---|---|
| ⌃⇥ / ⌃⇧⇥ | ルームのセッションが 1 ページに収まらないときに、次 / 前のタブへ。 |
| Esc | 拡大表示中のセッションを離れ、ルーム全体に戻る。 |
マシンとターミナル
| ショートカット | 操作 |
|---|---|
| ⇧⌘N | 新規ワークスペース…(新しいマシン)。 |
| ⌥⇧⌘N | 自分の構成から新規ワークスペース…(⌥ を押しながら同じメニュー項目)。 |
| ⇧⌘K | リモートの Bromure に接続… |
| ⌘T | 選択したマシンのターミナルで 新規タブ — ブラウザペインにキーボードフォーカスがあるときは、新しいブラウザタブ。 |
| ⌘D | ターミナルをグリッドに追加。 |
| ⇧⌘G | 新規ワークツリー(マシンのターミナルで)。 |
| ⇧⌘M | ワークツリーをマージ(マシンのターミナルで)。 |
ボード、ウインドウ、レビュー
| ショートカット | 操作 |
|---|---|
| ⇧⌘A | オートメーションボード。 |
| ⇧⌘T | タスク(コーディングタスクボード)。 |
| ⌘0 | ワークスペースマネージャー。 |
| ⇧⌘I | トレースインスペクタ… |
| ⌘R | 更新(レビューウインドウとブランチウインドウ)。 |
| ⇧⌘⏎ | コメントをエージェントに送る(レビューウインドウ)。 |
ディスク上の場所
アプリが所有するものはすべて 1 つのサポートディレクトリに置かれ、そのほかにいくつかのファイルがその外に、いくつかの項目がキーチェーンにあります。/ で終わるパスはディレクトリです。
サポートディレクトリ
アプリのサポートルートは ~/Library/Application Support/BromureAC/ です。以下のパスはこれに対する相対パスです。
| パス | 内容 |
|---|---|
base.img | 各マシンがクローンする Ubuntu のベースイメージ(論理サイズ 24 GB、物理的には数 GB)。 |
efivars.bin | ベースイメージが起動時に使用する EFI 変数ストア。 |
base.version | インストールされたイメージのバージョンスタンプ。例: 201 または 201.1。 |
image-state.json | イメージの由来と、適用されたポストインストールステップの UUID。 |
img-catalog.json | ダウンロードしたイメージカタログのキャッシュコピー。 |
browser-img-catalog.json | 組み込みブラウザイメージ用のキャッシュされたカタログ。 |
catalog.json | デバイス上のモデルのリモートカタログのキャッシュ。 |
base.img.partial、base.img.gz.partial、efivars.partial | 一時的なインストールファイル。これらが存在する場合、インストールが実行中か中断されたことを意味します。 |
alpine-vmlinuz、alpine-initramfs、alpine-initramfs-shimmed | ローカルビルドで使用される、キャッシュされた Alpine netboot インストーラーファイル。 |
browser/ | Bromure Web のコピーがない場合の、AC 独自の Ubuntu + Chromium ブラウザイメージのコピー。 |
browser-profiles/<uuid>/image/profile.img | 暗号化された永続的な Chromium プロファイルディスク(「ウェブサイトにサインインしたままにする」)。 |
ca/cert.pem、ca/key.pem | インストールごとの Bromure Agentic Coding ルート CA(鍵のモードは 0600)。ローテーションするには ca/ ディレクトリを削除します。 |
control.sock | 所有者専用(0600)の Unix 制御ソケット。CLI と制御プレーンが HTTP で通信します。 |
profile-macs.json | マシンごとの決定論的な MAC アドレスの割り当て。 |
dhcp-leases.sqlite | マシンの仮想ネットワーク用の永続的な DHCP リース。 |
default-ssh/id_ed25519.raw、default-ssh/id_ed25519.pub | 新しいマシンごとにコピーされる、共有の既定の SSH 鍵ペア。 |
profile-template.json、profile-template.enc | 新しいマシンが継承する、環境設定の Defaults テンプレート。 |
models.enc | グローバルなモデル設定(環境設定 › モデル): プロバイダー、鍵、エージェントごとの選択。暗号化されています。 |
claude-subscription.enc、codex-subscription.enc、grok-subscription.enc、kimi-subscription.enc | ホストが所有する、暗号化されたサブスクリプションのサインイン(共有のもの、およびマシンごとの上書き)、0600。 |
sessions.json | エージェントセッション: タイトル、エージェント、マシン、フォルダ、状態、ニックネーム、ルーム。 |
rooms.json | ルーム。 |
delegations.json | セッション間の委任と依頼。 |
transcripts/ | 各セッションの会話のホスト側のコピー(<session-id>.jsonl)。 |
tasks.json、task-transcripts/ | コーディングタスクボードと、アーカイブされたトランスクリプト。 |
automations.json | スケジュールされたオートメーションに加え、実行履歴、次回の起動時刻、イベントのポーリングの最高到達点。 |
runs/<id>/ | アーカイブされたオートメーションの実行(record.json、transcript.jsonl)。 |
security-timeline/<yyyy-MM-dd>.jsonl | セキュリティタイムライン。1 日 1 ファイルで、90 日間保持されます。 |
pii/<uuid>.key | 個人データの代替値の一貫性を保つ、マシンごとのシークレット(0600)。 |
grid-layout.json | グリッドの構成。 |
engine-master.key | VM ごとのデバイス上エンジンの鍵のためのマスターシークレット。 |
engine-spawn.json | デバイス上エンジンの起動設定(モデル、メモリ予算、ポート)。 |
fake-salt.bin | 代替トークンを導出するための、インストールごとのソルト(0600)。削除すると、この Mac のすべての代替値が切り替わります。 |
secrets-master.key | Data Protection キーチェーンに到達できない場合にだけ使われる、0600 の予備のマスターキー。 |
cloudflared/<version>/cloudflared | 固定され、チェックサム検証済みの cloudflared バイナリ。並びに current シンボリックリンク。 |
ghostty/ | 生成されたターミナルの設定(ベースとマシンごと)。 |
マシンごとのストレージ
各マシンは、サポートルート以下の profiles/<uuid>/ にある独立したディレクトリです。これらの使われ方については、マシンとコンセプトとアーキテクチャを参照してください。
パス(profiles/<uuid>/ 以下) | 内容 |
|---|---|
profile.json | セキュリティポリシーを含むマシンの定義。socket.dev と Depi の API キーはここにホスト側で保存され、VM にコピーされることはありません。既定以外のフィールドだけが書き込まれます。 |
secrets.enc | 暗号化されたマシンのシークレット(0600)。 |
disk.img | システムディスク — base.img の APFS コピーオンライトクローン。 |
home.img | /home/ubuntu を保持するスパースな ext4 イメージ。 |
home/ | 旧来の共有フォルダ型のホーム(まだアップグレードされていないマシン)。 |
checkpoints/、checkpoints/home/ | 起動ごとのディスクとホームのチェックポイント(ホームのものは ホームを巻き戻す… に一覧表示されます)。 |
vm.state、vm.state.json | サスペンドした VM の RAM スナップショットと、それを保存したときの構成のフィンガープリント。 |
tabs.json | 保存されたターミナルタブのレイアウト。vm.state が存在する場合にのみ使われます。 |
machine-identifier.bin | 永続的な VM の識別情報(サスペンドした VM の復元に必要)。 |
compromised.flag | 侵害の後に設定される、次回起動時に消去するためのマーカー。 |
meta-share/ | 起動ごとの読み取り専用のゲスト設定共有(api_key.env、proxy.env、CA 証明書、ゲストのヘルパー、MCP のシムと設定)。 |
outbox/ | 起動ごとの書き込み可能なゲスト→ホストイベント共有。 |
agent/(と agent/imported/)、ssh/ | マシンごとの SSH 鍵の素材。インポートした鍵は agent/imported/ の下にあり、ssh/ は旧来のディレクトリです。 |
クラスタ、レジストリ、メッセージングコネクタ
| パス(サポートルート以下) | 内容 |
|---|---|
kube/clusters.json | すべての Kubernetes クラスタ、レジストリ、メッセージングコネクタと、その設定とアクセスリスト。 |
kube/<id>/kubeconfig.yaml | クラスタの管理者用 kubeconfig(kubeconfig をコピー がコピーするもの)。 |
kube/<id>/setup.log | クラスタまたはレジストリのセットアップとライフサイクルのログ(その ログ タブ)。 |
kube/<id>/synology.enc | 設定されている場合、暗号化された Synology NAS の認証情報。 |
kube/<id>/nodes/<uuid>/ | 各ノード(またはレジストリ、コネクタ)専用のマシンディレクトリ: disk.img、使われる場合はデータディスク data.img、meta-share/ など。 |
モデルと検出器
| パス(サポートルート以下) | 内容 |
|---|---|
models/<org>--<name>/ | ダウンロードされたデバイス上のモデルの重み。 |
models/<org>--<name>/.incomplete | 進行中または中断されたダウンロードのマーカー。 |
Models/prompt-injection/ | PromptGuard 検出器のアセット(model.onnx、トークナイザーファイル、オプションの bromure-injection.json オーバーライド)。 |
Models/claudemd-guard/ | ModernBERT ルールファイル検出器のアセット。 |
Models/pii-rampart/ | 個人データ保護用の Rampart モデル。アプリに同梱されていない場合(開発ビルド)にのみ存在します。 |
traces/YYYY-MM-DD/<sessionID>.jsonl | セッションごとのトレースメタデータ。1 行につき 1 つの JSON レコード。 |
traces/YYYY-MM-DD/<sessionID>/<recordID>.req.enc、.res.enc | 取得したリクエスト / レスポンスの本文。暗号化されています(0600)。 |
登録、リモートアクセス、リッチクライアント
| パス(サポートルート以下) | 内容 |
|---|---|
managed/install.json | 登録の識別情報: インストール ID、組織のスラッグ、ユーザー、サーバー URL、デバイス名、登録日時。 |
managed/leaf.crt | mTLS のリーフ証明書(PEM)。 |
managed/leaf.serial | 現在のリーフの秘密鍵を保持する Keychain エントリへのポインタ。 |
managed/ca.crt | 組織の CA 証明書(PEM)。 |
managed/health | 永続化された登録の健全性(ok / tokenRejected / revoked)。 |
remote/hostkey_ed25519、remote/hostkey_ed25519.pub | 組み込み SSH サーバーのホスト鍵(ディレクトリのモードは 0700、鍵は 0600)。 |
remote/authorized_keys | SSH の正面玄関を通過できる公開鍵(0600)。 |
remote/overlay-key | SSH リモートメニュー用のオプションのオーバーレイキーコードオーバーライド。 |
remote-client/id_ed25519、.pub | リッチクライアントの SSH クライアント鍵ペア(コメント bromure-ac-fatclient)。 |
remote-client/known_hosts | リモートホスト鍵の Trust-on-first-use ピン。 |
remote-client/hosts.json | 保存されたリモートサーバー(「最近使用したサーバー」)。 |
remote-client/hosts/<host-UUID>/… | ホストごとのミラーの永続化(グリッドレイアウト、オートメーション)。リモートの状態でローカルの状態が上書きされることはありません。 |
メモ:
remote-client/サブツリーはCFFIXED_USER_HOMEとともに再配置されます。これにより、テスト用に 2 つの分離されたインスタンスを並行して実行できます。
サポートディレクトリの外部
| パス | 内容 |
|---|---|
~/Library/Logs/BromureAC/bromure-ac.log(と .log.1) | アプリのログ: アプリが標準エラー出力に書き込むすべての内容のコピーで、起動、終了、致命的シグナルのスタンプ付き。起動時に 8 MB を超えているとローテーションされ、1 つ前のファイルが保持されます。 |
~/Library/LaunchAgents/io.bromure.agentic-coding.boot.plist | ログイン時起動用の LaunchAgent。いずれかのマシンで「ログイン時にこの VM を起動」を有効にすると書き込まれます。 |
<app>/Contents/Library/LaunchDaemons/io.bromure.fatclient-tunnel.plist | 組み込みの特権トンネルデーモン。必要に応じて登録されます。 |
/var/run/io.bromure.fatclient-tunnel.sock | 特権トンネルデーモンのソケット(root が作成、0600、コンソールユーザーが所有)。 |
/tmp/bromure-ac-cm-<first-12-of-host-UUID> | ホストごとの SSH ControlMaster ソケット(サポートのパスは Unix ソケットには長すぎるため /tmp に置かれます)。 |
/tmp/bromure-repair.log | ローカル推論の修復プロキシのデバッグログ(BROMURE_REPAIR_DEBUG を指定した場合のみ)。 |
/usr/local/bin/bromure-cli | コマンドラインツールをインストール… で作成される、アプリのバイナリへのオプションの CLI シンボリックリンク。 |
<NSTemporaryDirectory>/bromure-ac-agent-<pid>.sock | Bromure のプライベートなホスト側 ssh-agent ソケット。 |
<NSTemporaryDirectory>/sessions-mirror.json、rooms-mirror.json、delegations-mirror.json | リッチクライアントが持つ、リモートホストのセッション、ルーム、委任の作業用コピー。 |
$TMPDIR/bromure/session-<uuid>.img(および -aux.img) | 一時的なブラウザ VM のコピーオンライトクローン。破棄時に削除されます。 |
~/Library/Application Support/Bromure/ | Bromure Web のサポートディレクトリ。AC は存在する場合ここからブラウザイメージを読み取ります。 |
Keychain アイテムとデフォルトドメイン
OS レベルの保護とともに存続する必要のあるシークレットは、ディスク上ではなく macOS Keychain に置かれます。
| Keychain サービス | アカウント | 内容 |
|---|---|---|
io.bromure.agentic-coding.master-key | v1 | シークレット保管庫のマスターキー(Data Protection キーチェーン)。 |
io.bromure.agentic-coding.ssh-key-passphrases | <profileUUID>/<filename> | インポートされた SSH 鍵のパスフレーズ。 |
io.bromure.agentic-coding.managed-install | install-token、leaf-cert-key-<serial> | 登録ベアラートークンとシリアルごとのリーフ秘密鍵。 |
このアプリのすべての UserDefaults はドメイン io.bromure.agentic-coding に置かれます(defaults read/defaults write で読み書きします)。
ネットワークポートとサブネット
TCP とループバックのポート
Bromure Agentic Coding はデフォルトでは固定のインバウンドポートを開きません。以下の 2 つのオプションサービスは有効にするまでオフです。それ以外はループバック専用で、動的または内部的なものです。
| ポート | 目的 | バインド先 |
|---|---|---|
9223(既定) | HTTP のオートメーション API と bromure-ac mcp のバックエンド。既定ではオフ(automation.enabled)。ブラウザ製品の 9222 の 1 つ隣なので、両方のアプリを同時に動かせます。GET /health を提供します。 | 127.0.0.1(automation.bindAddress で設定可能。ループバック以外へのバインドは認証されず、推奨されません)。 |
2222(デフォルト) | オプションの SSH リモートアクセスの正面玄関。デフォルトでは無効。1024 以上の任意のポートに設定可能。 | デフォルトは 0.0.0.0(remoteAccess.bindAddress で設定可能)。 |
28500~28599 | MCP OAuth コールバックリスナー(http://127.0.0.1:<port>/callback)。 | 127.0.0.1。 |
| 動的 | デバイス上の推論エンジン。11434 の Ollama/LM Studio との衝突を避けるため、初回起動時に割り当てられます。 | 127.0.0.1(0.0.0.0 にはなりません)。 |
| 動的 | ローカル推論のツールコール修復プロキシ。 | 127.0.0.1。 |
| エフェメラル | リッチクライアントのブラウザペインが使用する、リモートホストごとの SOCKS5 フォワーダー。 | 0.0.0.0 にバインドされますが、ループバックと 192.168.127.x にピアフィルタされます。 |
Mac 上ではなくゲストの内部に、2 つのループバックのエンドポイントがあります: 127.0.0.1:65534(すべてのシェルが HTTPS_PROXY としてエクスポートする VM 内の HTTP(S) プロキシ)と、127.0.0.1:11434(vsock 経由でホストの推論エンジンが現れる場所)です。
インストール自体は TCP ポートを開きません。ベースイメージビルドのパッケージプロキシは、ビルドごとにエフェメラルな localhost ポートにバインドします。
仮想ネットワークのサブネット
| サブネット | 目的 |
|---|---|
172.16.0.0/12 内のランダムな /24 | 新規インストールでのマシンのネットワーク(ゲートウェイ .1、DHCP プール .2〜.254)。インストールごとに一度選ばれ、Docker が通常使う 172.17〜172.20 と、Mac が属している範囲は除外されます。環境設定 › リソース › ワークスペースのサブネット で確認、オフ、再ランダム化ができます。 |
192.168.64.0/24 | プライベートサブネットをオフにしたインストールでのマシンのネットワーク。Mac の LAN がすでに使っている場合は自動で移されます。 |
192.168.65.0/24~192.168.126.0/24 | Bromure Web インスタンスが再配置される範囲。AC と Web が衝突しないようにします。 |
192.168.127.0/24 | リッチクライアントのローカルなブラウザ VM に固定されたサブネット(ゲートウェイ .127.1)。 |
10.98.<unit>.0/30 | 特権 utun トンネルデーモンが使用するポイントツーポイントリンクネットワーク。 |
IPv6 はルーティングされません: 最近のベースイメージはゲスト内で IPv6 を無効にしており、apt は IPv4 のみで動作します。
ホスト↔ゲストの vsock ポート
ホストとゲストは virtio ソケット(vsock)で通信します。vsock には IP アドレスがなく、ホスト(CID 2)と各ゲストの間の番号付きチャネルです。内部の仕組みですが、診断のためにここに記載します。
| vsock ポート | ブリッジ |
|---|---|
| 5800 | シェル実行エージェント — vm exec、コントロールソケットの exec ルート、ファイルパネルを支えます。 |
| 5010 | ループバック OAuth コールバックリレー(OAuth リダイレクトを VM 内の CLI に戻します)。 |
| 5830 | browser MCP サーバー。 |
| 5831 | タスクボードの MCP サーバー(コーディングタスクのみ)。 |
| 5832 | 計画ストリーム(コーディングタスクの計画)。 |
| 5833 | automations MCP サーバー。 |
| 5834 | infrastructure MCP サーバー。 |
| 5835 | delegation MCP サーバー。 |
| 5836 | switchboard MCP サーバー(スイッチボードのセッションのみ)。 |
| 8443 | HTTPS MITM プロキシ — ゲストの送信経路。 |
| 8444 | ssh-agent ブリッジ(SSH_AUTH_SOCK を支えます)。 |
| 8445 | AWS credential_process ヘルパー。 |
| 8446 | Claude サブスクリプショントークンのエージェントと、ホストの推論へのブリッジ(ゲストの 127.0.0.1:11434)。 |
| 8447 | Codex/ChatGPT サブスクリプショントークンエージェント。 |
| 5000 | ブラウザ VM 設定エージェント(クレーム時のホスト→ゲスト JSON 設定)。 |
| 5100 | ブラウザ VM のファイル転送ブリッジ。 |
| 5200 | ブラウザ VM の Chrome DevTools Protocol ブリッジ(スクリーンショット、eval)。 |
| 5300 / 5400 | ブラウザ VM のリンク送信 / ウェブカメラ。 |
| 5810 | ブラウザ VM のネイティブタブブリッジ。 |
| 5900 | ブラウザ VM のネットワークトレースブリッジ。 |
環境変数と起動引数
これらは起動時にアプリに影響します。ほとんどはデバッグ、テスト、またはソースからのビルド用です。対象者 列は、それぞれが誰のためのものかを示します。バイナリを起動する前に環境変数を設定するか、起動後に起動引数として渡します。
| 名前 | 効果 | 対象者 |
|---|---|---|
-AppleLanguages "(fr)"(起動引数) | macOS 標準の言語の上書き。UI の言語を強制します。 | エンドユーザー |
BROMURE_DEBUG_CLAUDE | TCP のオートメーション API で制御ルートとデバッグ用エンドポイントを開き、AppleScript/MCP のプロファイル JSON ブリッジでシークレットをそのまま通し、bromure-ac mcp --debug の VM ツールに必要です。 | 上級ユーザー / デバッグ |
BROMURE_AC_DEBUG=1 | 自動化エンジン、インジェクション分類器、ルールスキャナー、トレースパイプライン向けのタイムスタンプ付き stderr デバッグ。 | デバッグ |
BROMURE_CLI_DEBUG | CLI コマンド向けの、stderr への詳細な制御ソケット接続診断。 | デバッグ(CLI) |
BROMURE_REPAIR_DEBUG | ローカル推論の修復プロキシのリクエスト/レスポンス診断。/tmp/bromure-repair.log に追記されます。 | デバッグ(ローカルモデル) |
BROMURE_INFER_DEBUG | リクエストごとのエンジンの統計(スロット、プレフィルしたトークン数、最初のトークンまでの時間、tok/s)を stderr に出力。 | デバッグ(ローカルモデル) |
BROMURE_FATCLIENT_LOG | バッファリングされないリッチクライアントの stderr ロギング。 | デバッグ(リモート) |
BROMURE_ATTACH_DEBUG=<path> | リッチクライアントのログをファイルにも追記します。 | デバッグ(リモート) |
BROMURE_NO_TRANSPARENT | すべてのマシンで透過的インターセプトをオフにします(プロキシの設定に従うプログラムでは、プロキシは引き続き機能します)。 | デバッグ |
BROMURE_INJECTION_COREML=1 | インジェクション分類器を CoreML/Neural Engine のプロバイダーで実行します(既定は CPU。CoreML は同じ精度で数倍のメモリを使います)。 | 上級ユーザー |
BROMURE_NO_COREML | BROMURE_INJECTION_COREML が設定されていても、分類器の CoreML を強制的に無効化します。 | パワーユーザー |
BROMURE_PII_BUDGET | 個人データのモデルが、パターンルールだけにフォールバックする前に、リクエストごとに読む新しいテキストの文字数(既定 300000)。 | 上級ユーザー(個人データ) |
BROMURE_PII_MIN_SCORE | 個人データのモデルが値を置き換えるのに必要な確信度(既定 0.6)。 | 上級ユーザー(個人データ) |
BROMURE_PII_THREADS | 個人データのモデルが使う CPU スレッド数(既定: 高性能コア、2〜8)。 | 上級ユーザー(個人データ) |
BROMURE_TRANSCRIPT_HISTORY_BYTES | チャットが最初に読み込む長い会話の量(既定は約 24 MB)。小さい値はテスト用です。 | テスト |
BROMURE_GPU_CACHE_GB | MLX GPU バッファキャッシュの上限(GB 単位、デフォルト 4)。 | パワーユーザー(ローカルモデル) |
BROMURE_KVBITS、BROMURE_KVBITS_START、BROMURE_CACHE_SLOTS、BROMURE_THINKING | デバイス上の推論の調整: KV キャッシュの量子化ビット数としきい値、KV キャッシュのセッションスロット、そして非表示の思考の無効化。モデルとプロバイダーを参照してください。 | 上級ユーザー(ローカルモデル) |
VISUAL / EDITOR | bromure-cli workspaces edit が使用するエディタ(vi にフォールバック)。 | エンドユーザー(CLI) |
BROMURE_MANAGED_URL | 登録、ハートビート、証明書発行に使用される bromure.io API ベースをオーバーライドします。 | エンタープライズ管理者 |
BROMURE_FATCLIENT_OPEN | リッチクライアント専用の起動: 初回セットアップをスキップします(ローカルのベースイメージは不要)。 | 上級 / テスト |
BROMURE_DEBUG_WIZARD | 実際のインストールなしで、オンボーディングウィザードを指定したステップ(scan、pick、models、done)で開くか、newworkspace で開いているホームの上で実行します。 | テスト / スクリーンショット |
BROMURE_EDITOR_CATEGORY | 設定エディタを指定したペインで開きます。 | テスト / スクリーンショット |
BROMURE_IMAGE_CATALOG_BASE | イメージのダウンロードをローカル/ステージングカタログに向けます。カタログの署名検証も無効化します。テストおよびパイプライン専用。 | テスト / CI |
BROMURE_INSTALL_BROWSER_IMAGE=1 | 起動時に、組み込みブラウザイメージの AC 独自のコピーを自動でダウンロードします。 | テスト / デバッグ |
CODESIGN_IDENTITY | build.sh の署名アイデンティティ。未設定の場合はアドホックな - にフォールバック(Gatekeeper、iCloud、vmnet なし)。 | 開発者(ビルド) |
DEVELOPER_ID、APPLE_ID、TEAM_ID、APP_PASSWORD | package.sh による Developer ID 署名と公証。 | 開発者 / 配布者 |
DRY_RUN=1、KEEP_PREVIOUS=1、KEEP_STAGING=1 | イメージの公開/リハーサルパイプラインのスイッチ。 | 公開者 |
エンジンは自分の子プロセス用の内部変数(BROMURE_ENGINE_KEY、BROMURE_ENGINE_MASTER)も設定し、使い捨てのサインイン VM は BROMURE_AC_REGISTER を設定します。これらは手で設定するものではありません。
UserDefaults キー(defaults write)
io.bromure.agentic-coding ドメインの永続的な設定。ほとんどは UI に対応する項目があります。vm.* と開発者向けの設定は、アプリが動いていないときに defaults write で設定します。
| キー | 効果 | デフォルト |
|---|---|---|
automation.enabled | ループバック自動化 HTTP API をオンにします。 | false |
automation.port | 自動化 API のポート。 | 9223 |
automation.bindAddress | 自動化 API のバインドアドレス。 | 127.0.0.1 |
remoteAccess.enabled | SSH リモートアクセスの正面玄関を有効にします。 | false |
remoteAccess.port | SSH 正面玄関のポート(1024 以上)。 | 2222 |
remoteAccess.bindAddress | SSH 正面玄関のバインドアドレス。 | 0.0.0.0 |
remoteAccess.passwordAuth、remoteAccess.pubkeyAuth | SSH 認証方式。 | 両方オン |
ui.sessionsFirst | セッションのホーム。オフにすると、メインウインドウはマシンとターミナルのレイアウトに戻ります。 | true |
ui.beautifiedTranscript | エージェントセッションを、生のターミナルではなくチャットとして表示します。 | true |
sessions.archivedExpanded | サイドバーの アーカイブ済み の折りたたみが開いているかどうか。 | false |
ui.terminalBell | ターミナルのベルを鳴らす(エージェントはターンの終わりごとにベルを鳴らします)。 | false |
terminal.allowGraphics | ゲストからのターミナル内の画像表示を許可します。高度な操作を参照してください。 | false |
vmnet.useRandom172 | マシンを 172.16.0.0/12 内のランダムなプライベートサブネットに置きます(環境設定 › リソース › ワークスペースのサブネット)。 | 新規インストールでは true |
proxy.noMitmDomains | HTTPS をインターセプトせずに通す追加のドメイン(リモートアクセス… › インターセプトしない(MITM 対象外ドメイン))。 | 空 |
p2p.udpRelay.enabled | リモート接続で実験的な UDP リレーを優先します(環境設定 › リソース)。 | false |
vm.homeImageGB | 新しい ext4 のホームイメージの見かけ上のサイズ(GiB、8〜1024、スパース)。 | 16 |
vm.mtu | ゲストの NIC の MTU の上限 — ダウンロードが消えてしまう VPN 環境のホストでは下げてください。 | 1280 |
vm.networkMode、vm.bridgedInterface、vm.dnsServers | ブラウザ VM のネットワークモード、ブリッジのインターフェイス、DNS の上書き。 | モードは NAT、ほかは未設定 |
vm.extraChromeFlags、vm.chromeEnvExtra | ブラウザ VM の Chromium 起動に付加される開発者向けのノブ。 | 未設定 |
cloudflareTunnel.consented | Cloudflare クイックトンネル経由で HTTP サービスを公開することへの一度限りの同意。 | false |
catalog.refreshDisabled | デバイス上のモデルのカタログをダウンロードせず、同梱とキャッシュのコピーを使います。 | false |
ac.sidebarWidth.v2、ac.filePaneOpen | 保存されたサイドバーの幅とファイルパネルの状態。 | アプリが設定 |
ゲスト VM チートシート
実行中のマシンの中では、あなたはホームが /home/ubuntu の一般ユーザー ubuntu(sudo 可能)です。ホストがマウントと環境を整えるため、パッケージマネージャー、エージェント、Git はゲスト内で何も設定せずに動作します。仕組みについてはコンセプトとアーキテクチャを参照してください。
マウントポイントとパス
| パス | 内容 |
|---|---|
/home/ubuntu | あなたのホーム — ext4 の home.img(まだアップグレードされていないマシンでは共有フォルダ)。 |
/mnt/bromure-meta | 起動ごとの読み取り専用の設定共有: api_key.env、proxy.env、CA 証明書、ゲストのヘルパー、MCP のシムと設定、ホスト名と MTU のヒント。 |
/mnt/bromure-meta/bromure-*-mcp.py | 組み込み MCP サーバーの stdio↔vsock シム(browser、task、automations、infra、delegation、switchboard)。 |
/mnt/bromure-outbox | 書き込み可能なゲスト→ホストのイベント共有。 |
/mnt/bromure-share-N | 共有プロジェクトフォルダ(最大 8 個)。~/<basename> としてホームにもシンボリックリンクされます。 |
~/.bromure/inbox/<id>/ | ほかのエージェントが委任や依頼とともにこのセッションに送ったファイル。 |
~/.bromure/switchboard | スイッチボードのフォルダ。その CLAUDE.md がスイッチボードへの指示書です。 |
~/.bromure/rooms/<slug> | ルームのスイッチボードのフォルダ。 |
~/.bromure/pastes/ | マシンのターミナルにペーストまたはドロップしたファイル(7 日後に自動で削除されます)。 |
ホストが設定する環境
| 変数 | 値 / 効果 |
|---|---|
http_proxy、https_proxy、HTTPS_PROXY | http://127.0.0.1:65534 — すべてのゲスト HTTPS をホストの MITM プロキシに運ぶ VM 内ブリッジ。 |
NO_PROXY | localhost,127.0.0.1,::1。 |
SSH_AUTH_SOCK | /tmp/bromure-agent.sock — vsock 経由でホストの ssh-agent にブリッジされています(到達できるのはマシン固有の鍵と明示的にインポートした鍵だけで、macOS のログイン用エージェントが公開されることはありません)。 |
| CA バンドル変数 | 再署名ルート CA は、node、python、go、rust、curl、deno、AWS SDK 向けの標準バンドル変数を通じて信頼されます。 |
| エージェントの API キー | ANTHROPIC_API_KEY、OPENAI_API_KEY、XAI_API_KEY、GH_TOKEN、GITLAB_TOKEN、DIGITALOCEAN_ACCESS_TOKEN、LINEAR_API_KEY、TWILIO_ACCOUNT_SID / TWILIO_AUTH_TOKEN、AWS の変数、そしてデータベースやカスタムの変数 — すべて代替値で、ホストが通信経路上で本物のシークレットに差し替えます。 |
| デバイス上のモデルとカスタムサーバーのモデル | Claude Code には ANTHROPIC_BASE_URL=https://bromure.llm、VM ごとの ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL とそのサイズ別エイリアスに入った本物のモデル ID、そして CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 が見えます。 |
| OpenRouter | Claude Code には ANTHROPIC_BASE_URL=https://openrouter.ai/api、代替の ANTHROPIC_AUTH_TOKEN、空の ANTHROPIC_API_KEY、そしてサイズごとに選んだモデル ID が見えます。 |
| Amazon Bedrock | Claude Code には CLAUDE_CODE_USE_BEDROCK=1、AWS_REGION、そして代替の AWS_BEARER_TOKEN_BEDROCK(Bedrock の API キー)または AWS_PROFILE=default(AWS 認証情報)のどちらかが見えます。 |
KIMI_CODE_OAUTH_HOST、KIMI_CODE_BASE_URL | Kimi のサブスクリプションがある場合: Kimi Code を Kimi の国際版サービスに向けます。 |
BROMURE_REGISTRY | このマシンがアクセスできる Bromure のレジストリのアドレス。 |
警告: ゲストが読めるすべての認証情報はおとりです。あるホストに限定された代替トークンが、別のホスト宛てのリクエストに現れるのは持ち出しの兆候であり、侵害検出を作動させます — それで何かが認証されることは決してありません。