チャットを始める

BRICKS CTORを初めて起動すると、メインチャットに着地します——プロジェクトに依存しないエージェントで、新しいBRICKSアプリのスキャフォールド、ローカルデバイスの一覧表示、Activity Logの参照、過去のチャットセッションの確認、他のセッションのオーケストレーションを、プロジェクトを開かずに行えます。 プロジェクトを作成または開いた後は、コードレベルの作業のためにプロジェクトスコープのチャットに切り替えられます。それまでは、メインチャットが出発点です。

​

メインチャットを使う場面

作業が単一のプロジェクトに紐づかないときにメインチャットを使います：

• 新しいアプリをゼロから立ち上げ、まだディレクトリがない
• ネットワーク上のデバイスや、それらが最近ログに記録した内容を確認する
• 数週間前の決定を思い出すために過去のチャットを横断検索する
• アドホックな bricks CLIチェックを実行する（bricks doctor、bricks device list など）

特定のプロジェクト内の編集——コードの変更、デプロイ、Previewペイン、MCPサーバー——には、そのプロジェクトを開いてプロジェクトセッションを開始してください。

​

配置

サイドバーは折りたたみ可能な2つのセクションに分かれます：

• Projects — 登録済みのBRICKSプロジェクト。+ をクリックしてディスクからプロジェクトを登録します。
• Chat — メインチャットのセッション。+ をクリックして新しいメインチャットを開始します。

2つのセクションの間には水平の区切り線があり、一目で見分けられます。セクションヘッダーをクリックすると折りたたまれ、CTORは次回起動時もその状態を覚えています。

​

メインチャットを開始する

1. CTORを開きます。アクティブなセッションがなければ、空の Main Chat 画面が中央寄せの入力バーとともに表示されます。
2. 依頼を入力します——例：「hello-worldのBRICKSアプリを作って」——そして Ctrl+Enter を押します。
3. CTORは最初の送信時にメインセッションを作成し、チャットが始まります。

サイドバーの Chat ヘッダーの横にある + をクリックして、いつでも新しいメインチャットセッションを開始することもできます。

​

メインワークスペース

メインエージェントは ~/bricks-ctor 内で動作します。これは通常のファイルマネージャーで参照できるトップレベルのディレクトリです。エージェントが書き込むもの——例えば bricks app ctor-init でスキャフォールドしたプロジェクト——は、別途指示しない限りここに置かれます。 このディレクトリはエージェントの作業ルートとして機能し、サンドボックス、ファイルメンション（@）、スキルのスコープの基準になります。エージェントがプロジェクトを登録すると（後述）、そのプロジェクトディレクトリはサンドボックスモードでもメインエージェントから読み取り可能になります。 メインワークスペースは、設定 → エージェント → メインチャットの作業ディレクトリから別の場所（外部ボリュームや同期フォルダーなど）に変更できます。変更はアプリを再起動せずにセッション中でも即時に反映されます。

​

ワークスペースレベルのツール

標準のファイル・シェルツールに加えて、メインエージェントにはワークスペースレベルのツールがあり、プロジェクトセッションでは利用できません： メインエージェントはBRICKS固有の操作に bricks CLIを使用します。例えば bricks app ctor-init（プロジェクト作成）、bricks device list と bricks device monitor（デバイス確認）、bricks activity-log（監査履歴）など。コマンドの全体についてはBRICKS CLIリファレンスを参照してください。

​

セッションオーケストレーション

メインチャットは、現在の会話を離れることなく、他のチャットセッションを生成・管理できます。これにより、集中したタスクを委任できます——例えばプロジェクトセッションにモジュールのリファクタリングを依頼するなど——メインチャットを調整ハブとして維持しながら作業を進められます。

​

セッションの生成

new_session にタイトルと最初のメッセージを渡して呼び出します。projectPath を省略（または MAIN を渡す）すると、別のメインチャットセッションが作成されます。プロジェクトディレクトリのパスを渡すと、そのプロジェクトのプロジェクトスコープセッションが作成されます。このツールは即座に返り、対象セッションはバックグラウンドで実行されます。

​

既存セッションへの送信

send_session_message を呼び出して、完了済みまたは実行中のセッションにフォローアップメッセージを送信します。steer を true に設定すると、現在実行中のセッションをリダイレクトします。オプションの undo_messages_index パラメータを使うと、送信前に特定のユーザーメッセージまでロールバックできます。

​

セッションの停止

stop_session を呼び出すと、実行中のセッションを中止できます。セッション履歴は保持されます。

​

完了レポート

対象セッションが完了（または停止）すると、Session report メッセージが自動的にメインチャットにキューイングされ、エージェントが結果を確認して作業を続行できます。レポートが保留中の間、入力バーの上に Session report queued インジケーターが表示されます。インジケーターの Cancel ボタンをクリックすると、保留中のレポートをキャンセルできます。

​

URLから共有アプリを複製する

メインチャットに共有URLを貼り付けると、エージェントが元のアプリをワークスペースに複製します。次の2種類のURL形式を認識します：

• https://control.bricks.tools/#/create-share-app?application_id=<id> — BRICKS Controllerのリリースページからコピーした「共有から作成」リンク。
• https://share.bricks.tools/app/<id> — 公開共有ページのリンク。

エージェントはURLから元のアプリIDを抽出し、bricks app share-info で公開リリースを一覧表示し、どれを複製するか（任意で名前と説明も）尋ねた上で、bricks app share-new で新しいアプリを作成します。新しいアプリはアクティブなプロファイルのワークスペースに作成されます——別のワークスペースに作成したい場合は、先にプロファイルを切り替えてください。 新しいアプリの作成後、エージェントはそれ用にローカルプロジェクトをスキャフォールドするかを尋ねます——share-new --init -y を同じコマンドで再実行するか、メインワークスペースで bricks app ctor-init <new-app-id> を呼び出し、続いてプロジェクトを登録してサイドバーに表示させます。

​

Created projects バナー

メインエージェントが open_created_project を介してディスク上のプロジェクトを登録するたびに、チャット下部に Created projects カードが表示されます。各カードにはプロジェクト名、アプリID、ステージが表示されます。Start session をクリックすると、そのプロジェクトを開いてプロジェクトスコープのチャットを開始します——CTORはプロジェクトを開き、サイドバーで選択し、新しいセッションを1ステップで作成します。

​

ハンドオフコンテキスト

メインチャットがそのプロジェクトをスキャフォールドした場合、エージェントは会話のサマリーをプロジェクトルートの CONTEXT.md として保存し、プロジェクトの AGENTS.md（または CLAUDE.md）に @CONTEXT.md 参照を追加できます。最初のプロジェクトセッションはそのコンテキストを自動的に読み込むので、メインチャットでの決定を再度説明する必要はありません。 このマーカーはべき等です——ツールを2回実行してもリンクは重複しません。

​

スキル、サブエージェント、MCP

メインチャットはプロジェクトセッションよりも限定された機能セットを使います：

• スキル と サブエージェント は利用可能ですが、バンドル済みとグローバル層のみです——プロジェクトローカルなスキルとエージェントは、特定のプロジェクトがスコープに入っていないため意図的に非表示になります。
• MCPサーバー はメインチャットでは公開されません。
• Previewはプロジェクト専用のため、Preview ボタンは非表示になります。

それ以外——モデルセレクター、思考レベル、サンドボックスモード、ファイルメンション、画像添付、Local Devices ダイアログ、メッセージボタン——はプロジェクトチャットと同じように動作します。ワークスペースプロファイルピルの動作だけは異なります。下のワークスペースプロファイルの切り替えを参照してください。

​

ワークスペースプロファイルの切り替え

サンドボックスモードセレクターの隣にあるピルは、現在アクティブなプロファイルを表示します。ピルが読み取り専用のプロジェクトチャットとは違い、メインチャットでは認証済みプロファイルが複数あるとピルがドロップダウンに変わります。クリックして、メインエージェントを動作させたいワークスペースを選択してください。 プロファイルを切り替えると、CTORが組み込みの bricks CLI とツール環境に渡す BRICKS_PROFILE 環境変数が更新されるため、次のターンのシステムプロンプトとコマンド出力には選択したワークスペースが反映されます。

​

次のステップ