BRICKS CTORを初めて起動すると、メインチャットに着地します——プロジェクトに依存しないエージェントで、新しいBRICKSアプリのスキャフォールド、ローカルデバイスの一覧表示、Activity Logの参照、過去のプロジェクトセッションの確認を、プロジェクトを開かずに行えます。 プロジェクトを作成または開いた後は、コードレベルの作業のためにプロジェクトスコープのチャットに切り替えられます。それまでは、メインチャットが出発点です。Documentation Index
Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
Use this file to discover all available pages before exploring further.
メインチャットを使う場面
作業が単一のプロジェクトに紐づかないときにメインチャットを使います：- 新しいアプリをゼロから立ち上げ、まだディレクトリがない
- ネットワーク上のデバイスや、それらが最近ログに記録した内容を確認する
- 数週間前の決定を思い出すために過去のチャットを横断検索する
- アドホックな
bricksCLIチェックを実行する（bricks doctor、bricks device listなど）
配置
サイドバーは折りたたみ可能な2つのセクションに分かれます：- Projects — 登録済みのBRICKSプロジェクト。+ をクリックしてディスクからプロジェクトを登録します。
- Chat — メインチャットのセッション。+ をクリックして新しいメインチャットを開始します。
メインチャットを開始する
- CTORを開きます。アクティブなセッションがなければ、空の Main Chat 画面が中央寄せの入力バーとともに表示されます。
- 依頼を入力します——例：「hello-worldのBRICKSアプリを作って」——そして Ctrl+Enter を押します。
- CTORは最初の送信時にメインセッションを作成し、チャットが始まります。
メインワークスペース
メインエージェントは~/bricks-ctor 内で動作します。これは通常のファイルマネージャーで参照できるトップレベルのディレクトリです。エージェントが書き込むもの——例えば bricks app ctor-init でスキャフォールドしたプロジェクト——は、別途指示しない限りここに置かれます。
このディレクトリはエージェントの作業ルートとして機能し、サンドボックス、ファイルメンション（@）、スキルのスコープの基準になります。エージェントがプロジェクトを登録すると（後述）、そのプロジェクトディレクトリはサンドボックスモードでもメインエージェントから読み取り可能になります。
ワークスペースレベルのツール
標準のファイル・シェルツールに加えて、メインエージェントにはプロジェクトセッションでは利用できない4つのツールがあります：| ツール | 用途 |
|---|---|
open_created_project | プロジェクトディレクトリ（application.json を含む必要あり）を登録してサイドバーに表示します。任意でハンドオフメモを CONTEXT.md として書き込みます。 |
list_projects | 現在サイドバーに登録されているプロジェクトを一覧表示します。 |
list_project_sessions | 保存済みのチャットセッションを一覧表示します。プロジェクトでフィルタリング可能です。 |
read_project_session | IDで保存済みセッションを読み取り、コンパクトなトランスクリプトを返します。 |
bricks CLIを使用します。例えば bricks app ctor-init（プロジェクト作成）、bricks device list と bricks device monitor（デバイス確認）、bricks activity-log（監査履歴）など。コマンドの全体についてはBRICKS CLIリファレンスを参照してください。
URLから共有アプリを複製する
メインチャットに共有URLを貼り付けると、エージェントが元のアプリをワークスペースに複製します。次の2種類のURL形式を認識します：https://control.bricks.tools/#/create-share-app?application_id=<id>— BRICKS Controllerのリリースページからコピーした「共有から作成」リンク。https://share.bricks.tools/app/<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 ボタンは非表示になります。
ワークスペースプロファイルの切り替え
サンドボックスモードセレクターの隣にあるピルは、現在アクティブなプロファイルを表示します。ピルが読み取り専用のプロジェクトチャットとは違い、メインチャットでは認証済みプロファイルが複数あるとピルがドロップダウンに変わります。クリックして、メインエージェントを動作させたいワークスペースを選択してください。 プロファイルを切り替えると、CTORが組み込みのbricks CLI とツール環境に渡す BRICKS_PROFILE 環境変数が更新されるため、次のターンのシステムプロンプトとコマンド出力には選択したワークスペースが反映されます。
次のステップ
プロジェクトのセットアップ
プロジェクトを開くか作成して、プロジェクトスコープの作業に入ります。
AIエージェントの使い方
プロジェクトとメインの両方のセッションを駆動するチャットインターフェースを学びます。