> ## 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. # チャットを始める > 起動するとメインチャットに着地し、新しいプロジェクトのスキャフォールドやワークスペースレベルのワークフローを実行できる [BRICKS](https://bricks.tools) CTORを初めて起動すると、**メインチャット**に着地します——プロジェクトに依存しないエージェントで、新しいBRICKSアプリのスキャフォールド、ローカルデバイスの一覧表示、Activity Logの参照、過去のチャットセッションの確認、他のセッションのオーケストレーションを、プロジェクトを開かずに行えます。 プロジェクトを作成または開いた後は、コードレベルの作業のためにプロジェクトスコープのチャットに切り替えられます。それまでは、メインチャットが出発点です。 ## メインチャットを使う場面 作業が単一のプロジェクトに紐づかないときにメインチャットを使います： * 新しいアプリをゼロから立ち上げ、まだディレクトリがない * ネットワーク上のデバイスや、それらが最近ログに記録した内容を確認する * 数週間前の決定を思い出すために過去のチャットを横断検索する * アドホックな `bricks` CLIチェックを実行する（`bricks doctor`、`bricks device list` など） 特定のプロジェクト内の編集——コードの変更、デプロイ、[Previewペイン](/ja/ctor/reference/preview)、MCPサーバー——には、そのプロジェクトを開いて[プロジェクトセッション](/ja/ctor/guide/agent-usage)を開始してください。 ## 配置 サイドバーは折りたたみ可能な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` でスキャフォールドしたプロジェクト——は、別途指示しない限りここに置かれます。 このディレクトリはエージェントの作業ルートとして機能し、サンドボックス、ファイルメンション（`@`）、[スキル](/ja/ctor/reference/skills)のスコープの基準になります。エージェントがプロジェクトを登録すると（後述）、そのプロジェクトディレクトリはサンドボックスモードでもメインエージェントから読み取り可能になります。 メインワークスペースは、[設定 → エージェント → メインチャットの作業ディレクトリ](/ja/ctor/reference/settings#メインチャットの作業ディレクトリ)から別の場所（外部ボリュームや同期フォルダーなど）に変更できます。変更はアプリを再起動せずにセッション中でも即時に反映されます。 ## ワークスペースレベルのツール 標準のファイル・シェルツールに加えて、メインエージェントにはワークスペースレベルのツールがあり、プロジェクトセッションでは利用できません： | ツール | 用途 | | ---------------------- | ----------------------------------------------------------------------------------------------------------- | | `open_created_project` | プロジェクトディレクトリ（`application.json` を含む必要あり）を登録してサイドバーに表示します。任意でハンドオフメモを `CONTEXT.md` として書き込みます。 | | `list_projects` | 現在サイドバーに登録されているプロジェクトを一覧表示します。 | | `query_sessions` | タイトル（オプションでメッセージ本文も）から保存済みチャットセッションを検索し、ランク付きの結果を返します。クエリを省略すると最近のセッションを一覧表示します。プロジェクトでフィルタリング可能です。 | | `read_session` | IDで保存済みセッションを読み取り、コンパクトなトランスクリプトを返します。プロジェクトとメインチャットの両方のセッションで動作します。 | | `archive_session` | 保存済みセッションをアーカイブしてサイドバーから非表示にしますが、**Settings → Archive** から復元可能です。 | | `new_session` | 新しいメインチャットまたはプロジェクトスコープのセッションを作成し、最初のメッセージを送信して、完了レポートを受け取ります。[セッションオーケストレーション](#セッションオーケストレーション)を参照してください。 | | `send_session_message` | 既存のセッションにフォローアップを送信、実行中のセッションをステアリング、またはアンドゥして再送信します。 | | `stop_session` | IDで実行中のセッションを停止します。 | メインエージェントはBRICKS固有の操作に `bricks` CLIを使用します。例えば `bricks app ctor-init`（プロジェクト作成）、`bricks device list` と `bricks device monitor`（デバイス確認）、`bricks activity-log`（監査履歴）など。コマンドの全体については[BRICKS CLIリファレンス](/ja/cli/commands)を参照してください。 ## セッションオーケストレーション メインチャットは、現在の会話を離れることなく、他のチャットセッションを生成・管理できます。これにより、集中したタスクを委任できます——例えばプロジェクトセッションにモジュールのリファクタリングを依頼するなど——メインチャットを調整ハブとして維持しながら作業を進められます。 ### セッションの生成 `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=` — [BRICKS Controller](/ja/controller/applications#リリースと共有)のリリースページからコピーした「共有から作成」リンク。 * `https://share.bricks.tools/app/` — 公開共有ページのリンク。 エージェントはURLから元のアプリIDを抽出し、`bricks app share-info` で公開リリースを一覧表示し、どれを複製するか（任意で名前と説明も）尋ねた上で、`bricks app share-new` で新しいアプリを作成します。新しいアプリはアクティブなプロファイルのワークスペースに作成されます——別のワークスペースに作成したい場合は、先にプロファイルを切り替えてください。 新しいアプリの作成後、エージェントはそれ用にローカルプロジェクトをスキャフォールドするかを尋ねます——`share-new --init -y` を同じコマンドで再実行するか、メインワークスペースで `bricks app ctor-init ` を呼び出し、続いてプロジェクトを登録してサイドバーに表示させます。 ## 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** ダイアログ、**メッセージ**ボタン——はプロジェクトチャットと同じように動作します。ワークスペースプロファイルピルの動作だけは異なります。下の[ワークスペースプロファイルの切り替え](#ワークスペースプロファイルの切り替え)を参照してください。 ## ワークスペースプロファイルの切り替え サンドボックスモードセレクターの隣にあるピルは、現在アクティブな[プロファイル](/ja/ctor/guide/authentication#マルチプロファイルサポート)を表示します。ピルが読み取り専用のプロジェクトチャットとは違い、メインチャットでは認証済みプロファイルが複数あるとピルがドロップダウンに変わります。クリックして、メインエージェントを動作させたいワークスペースを選択してください。 プロファイルを切り替えると、CTORが組み込みの `bricks` CLI とツール環境に渡す `BRICKS_PROFILE` 環境変数が更新されるため、次のターンのシステムプロンプトとコマンド出力には選択したワークスペースが反映されます。 チャットに既にメッセージがある場合、ドロップダウンは2段階の確認を求めます——最初のクリックで対象プロファイルがフラグ付けされ（該当行がオレンジになり、ヘルパーテキストが切り替えによってエージェントコンテキストが再構築される旨を知らせます）、3秒以内に再度クリックすると切り替えが確定します。これにより、進行中のセッションがターンの途中で無音のままプロファイルを入れ替えることを防げます。 ## 次のステップ プロジェクトを開くか作成して、プロジェクトスコープの作業に入ります。 プロジェクトとメインの両方のセッションを駆動するチャットインターフェースを学びます。