Bromure Agentic Coding — ユーザーマニュアル

Bromure Agentic Coding の公式ユーザーマニュアルへようこそ。これは AI のコーディングエージェント — Claude Code、Codex、Grok、Kimi Code、Oh My Pi、そしてごく普通のシェルの道具立て — を、あなたの Mac の中の隔離された Linux 仮想マシンで走らせる macOS アプリで、ホスト側のゲートウェイがあなたの本物の認証情報をエージェントの手の届かないところに保ちます。

このマニュアルはバージョン 5.0.0 を扱います。Apple Silicon 上の macOS 14（Sonoma）以降が必要です。

バージョン 5.0.0 はセッションを軸に組み立てられています。エージェントとの各会話がサイドバーの 1 行で、あなたはチャットでそれに話しかけます。セッションが走る Linux VM は、メインウインドウではマシンと呼ばれます。設定エディタでは今もワークスペースと呼びますが、2 つの言葉は同じものを指します。

このアプリは初めてですか？ まずインストールと初回起動から始め、次にクイックスタートを辿ってください。全体像がほしくなったらコンセプトとアーキテクチャを読んでください。それ以外はリファレンスとして使ってください。

目次

はじめに

章扱う内容
1. はじめにこのアプリが何であるか、単一境界のセキュリティモデル、主な機能、そして他のツールとの比較。
2. インストールと初回起動必要なシステム、アプリのインストール、6 段階のオンボーディングウィザード、ベースイメージの更新、コマンドラインツール、ストレージ、新しい Mac への引っ越し、アンインストール。
3. クイックスタートウィザードから仕上がったタスクまで：セッションを始め、エージェントの質問に答え、変わったファイルを見て、トレースを調べ、そのあとセッションをアーカイブして呼び戻す。
4. コンセプトとアーキテクチャセッション、マシン、ルーム、ブランチ。セッションの状態。ホストとゲスト。ワイヤ境界。何が残るか。vsock と MCP のポート。ネットワーク。

日々の使い方

章扱う内容
5. セッションのホームメインウインドウ：サイドバーとその畳んだレール、セッションの行とそのメニュー、セッションのヘッダー、マシンメニュー、Linux のピル、⌘K のコマンドパレット、そしてアーカイブ、終了、削除、取り消し。
6. セッションを始める新規セッションの画面：エージェント、マシン、そしてどこで働くか（新しいフォルダ、あなたのフォルダの 1 つ、あるいはリポジトリ）を選ぶ、ファイルを添える、最近の開始、そして @ で別のセッションに尋ねる。
6.1 チャットエージェントと話す：入力欄、添付、スラッシュコマンドと行内のターミナル、質問カード、アクティビティの行、変更ファイルのまとめ、サインインのカード、停止、編集して再送、そして検索。
6.2 ルーム関連するセッションを 1 つのルームにまとめる：生きたチャットのグリッド、レイアウトとタブ、1 つのセルへのズーム、ルーム専用のスイッチボード、そしてルーム全体への送信。
6.3 ブランチとレビュー自分の git worktree の上のブランチセッション、それを戻してマージする、ブランチのウインドウ、そして行コメント付きのレビューウインドウ。
6.4 エージェントの協働子セッションへの委任、@ニックネームによる他セッションへのリクエスト、委任パネル、ファイルの受け渡し、限界、そしてマシンをまたぐリクエスト。
6.5 スイッチボードとメッセージング他のすべてのセッションを把握するスイッチボードのセッション、その安全規則、そして Signal・WhatsApp・Slack のためのメッセージングコネクタ。
6.6 マシン仮想マシンのセクション：マシンの作成、起動、一時停止、削除、ホームの巻き戻しとディスクのリセット、ターミナルとグリッド、ファイルペイン、そしてクリップボード。
6.7 組み込みブラウザセッションの隣にある Chromium ブラウザ：自分で操作する、ブラウザのツールを通してエージェントに操作させる、サインインを保つ、そしてプライバシー。
Bromure Web の Metal アクセラレーションスタンドアロンのウェブアプリ：Metal の要件、アプリ全体とプロファイルごとの設定、使用中のレンダラー、そして動画のサポート。
6.8 自動化かんばんボードの上での、予定された無人のエージェント実行：トリガー、スケジュール、連鎖、実行の履歴、その問いに答えること、そして自動化の MCP サーバー。
6.9 コーディングタスクコーディングのかんばん：タスク、エージェントが立てたフェーズ、worktree の中での自律的な実行、行コメント付きのレビュー、そしてマージ。

設定リファレンス

章扱う内容
7. 設定リファレンス設定エディタと環境設定の開き方、グループ分けされたペインの一覧と設定を検索、デフォルトのテンプレート、そして何がいつ保存されるか。

設定リファレンスには、エディタの順でペインごとに 1 ページあります：

セキュリティとワイヤ境界

章扱う内容
8. 認証情報とワイヤ境界本物の秘密がホストに留まり、エージェントには偽物だけが渡る仕組み：MITM プロキシ、サインインと API キー、認証情報ごとの承認、そして侵害アラート。
9. サプライチェーン保護エージェントが見る前にパッケージのインストールを検査し、書き換え、遮る：経過時間の関門、OSV、socket.dev、Depi、そしてインストールスクリプトの削ぎ落とし。
10. プロンプトインジェクションの検出とガードレールエージェントの AI 通信に差し込まれた指示を探すオンデバイスの検出器、エグレスファイアウォール、そして破壊的な操作へのガードレール。
10.5 個人データ保護会話があなたの Mac を離れる前に個人データを一貫した代替と入れ替え、返答の中でそれを戻す。
11. トレースと監査セッションのトレースが何を記録するか、トレースインスペクタ、保存時の暗号化、保持期間、書き出し、そしてプライバシー。
11.5 セキュリティ概要とタイムラインセキュリティ タイムラインのウインドウ：24 時間の概要、マシンごとの保護、そしてすべてのセキュリティ判断を絞り込み・書き出しできるタイムライン。

モデルとインフラ

章扱う内容
12. Fusion — マルチモデルパネル各プロンプトに複数のモデルで同時に答え、判定して、ワイヤ上では単一の返答にまとめる。
12.5 Squelch — ノイズを減らしてトークンを節約成功したテスト、進捗表示などのノイズをモデルが読む前にコマンド出力から取り除く仕組み（rtk に倣ったもの）と、セッションごとに節約したトークン。
13. モデルとプロバイダーグローバルなモデルの盤面：プロバイダー（サインイン、API キー、Amazon Bedrock、OpenRouter、カスタムサーバー、オンデバイスモデル）、エージェントごとのモデル選択、ワークスペースごとの上書き、そして稼働中の変更。
13.5 Kubernetes クラスタとレジストリあなたのマシンの隣で、それぞれの VM の中に k3s クラスタとプライベートなコンテナレジストリを走らせる：ストレージ、ロードバランシング、アドオン、アクセス、そしてインフラの MCP サーバー。

1 台の Mac を越えて

章扱う内容
14. リモートアクセスとリッチクライアント別の Mac、iPhone、iPad、Apple Vision Pro からリモートの Bromure をミラーする。リモートの環境設定。SSH 越しの CLI、トンネル、PAC。そしてリモートのセキュリティモデル。
15. エンタープライズ — 登録とフリートbromure.io への登録、テレメトリが何を送るか（そして何を送らないか）、フリートのビュー、そして離脱。

リファレンス

章扱う内容
16. CLI、API、MCPコマンドラインツール bromure-cli、ループバックの制御 API、MCP サーバー、そして AppleScript。
16.5 高度な操作上級者向けの道具：ext4 のファイルブラウザとファイルシステムの点検、そしてマシンのホームの復元や巻き戻し。
17. トラブルシューティングセットアップ、マシン、サインイン、TLS、サプライチェーン、ディスク容量、リモートアクセスの問題を、症状ごとに整理して診断する。
18. 用語集このマニュアルで使うすべての用語の定義。
19. 付録 — ファイルの場所、ポート、環境参照用の表：ディスク上の場所、ネットワークと vsock のポート、環境変数、既定値、キーボードショートカット、そしてゲストのチートシート。

このマニュアルの約束

  • 太字は、画面上のコントロールやラベルを、アプリが英語で見せるとおりに指します — ボタン、メニュー項目、トグル、ペイン、サイドバーのセクション（たとえば New session や Start this VM at login）。
  • 等幅の文字は、あなたが打ち込む、あるいは目にするコマンド、ファイルパス、環境変数、リテラルな値です（たとえば bromure-cli vm ls や ~/Library/Application Support/BromureAC）。
  • Workspaces › Infrastructure › Messaging Connector… のような並びはメニューの道筋です：メニュー、そして各サブメニューや項目を順に。環境設定 › モデルは、環境設定ウインドウのモデルペインを指します。
  • マシンとワークスペースは同じものを指します：設定を伴う 1 つの隔離された Linux VM です。メインウインドウはマシンと言い、設定エディタ、New Workspace… のようなメニュー、そして CLI はワークスペース（またはプロファイル）と言います。
  • セッションは、1 台のマシンの 1 つのフォルダでの、エージェントとの 1 つの会話です。マシンの実行そのものではありません。コンセプトとアーキテクチャを参照してください。
  • キーボードショートカットは macOS の記号を使います：⌘ Command、⌥ Option、⌃ Control、⇧ Shift、⏎ Return、⎋ Escape。
  • スクリーンショットは、作り物のデモ内容とともに英語のインターフェイスを示しています。アプリはローカライズされているので、あなたの画面はあなたの macOS の言語に従います。
  • 注、ヒント、警告は囲みとして現れます：

注： 知っておくと役に立つ背景の説明。

ヒント： 近道、あるいは勧められるやり方。

警告： 誤るとデータを失ったり保護を弱めたりしかねないこと。

ほかに見るべき場所

製品のダウンロード、技術ホワイトペーパー、詳しい機能マトリクスは bromure.io にあります。このマニュアルが答えていない問いについては、トラブルシューティングが診断の手順を集めており、用語集が語彙を定めています。