ワークツリー

プロジェクトの独立した git ワークツリーでチャットを実行します。各ワークツリーは独立したブランチであり、.bricks/worktrees/ の下に独自のチェックアウトを持つため、エージェントはメインのチェックアウトや他のチャットに影響を与えることなく、ブランチ上でビルドや実験ができます。満足したら、その成果をマージして戻します。

​

ワークツリーを選ぶ

ワークツリーピル（ブランチアイコンと現在のターゲット名）が、プロジェクトチャットの入力バーに他のセレクターと並んで表示されます。これはチャットが実行されるワークツリーを示し、デフォルトはメインです。 ターゲットを変更できるのは、チャットが空のあいだだけです。チャットにメッセージが入ると、ワークツリーはロックされます。ピルは表示されたままですが、開かなくなります（ツールチップは「このチャットのワークツリー（開始後はロックされます）」と表示されます）。 ピルをクリックすると、次の中から選べます：

• メイン——プロジェクトの主チェックアウト
• 既存のワークツリー（ワークツリー見出しの下に一覧表示）
• 新しいワークツリー…——新規に作成する

​

ワークツリーを作成する

**新しいワークツリー…**を選ぶと、新しいワークツリーダイアログが開きます。

• 任意の名前を入力します。入力すると、対応するブランチとフォルダーがライブプレビューで表示されます：.bricks/worktrees/<名前>。名前はスラッグ化されます——すべて小文字になり、スペースやその他の文字は - にまとめられ、最大 60 文字に制限されます。
• 名前を空欄にすると、brave-otter のような名前が自動生成されます。
• 作成をクリックします。CTOR はプロジェクトのデフォルトブランチからブランチと独立したチェックアウトを作成し、その中で bun install を実行します。チャットは自動的に新しいワークツリーに切り替わります。

作成に失敗した場合、未完成のワークツリーはロールバックされるため、クリーンな状態から再試行できます。 最初に作成するワークツリーは、.bricks/worktrees/ をプロジェクトの .gitignore に追加してその変更をコミットするため、チェックアウトされたワークツリーがプロジェクトにコミットされて戻ることはありません。

​

ワークツリーで作業する

ワークツリーチャットは、サイドバーのエントリーの横にブランチアイコンを表示します。エージェント（およびチャットが行うすべて）は、メインのチェックアウトから隔離された、ワークツリーのブランチとファイルに対して実行されます。 ワークツリーは main にマージを通じて統合される設計のため、チャットヘッダーのアクションメニューにある公開アクションは制限されます： 設定をプッシュとデプロイはデフォルトブランチの操作です——まず成果をマージして戻し、メインのチャットから公開してください。

​

main にマージする

チャットヘッダーのワークツリードロップダウンを開き、main にマージを選びます。CTOR は次を行います：

1. ワークツリーの保留中の変更をスナップショットコミットとしてコミットします。
2. ワークツリーのブランチを、メインのチェックアウト内のデフォルトブランチにマージします。

メインのチェックアウトはデフォルトブランチ上にあり、コミットされていない変更がない状態でなければなりません。そうでない場合、マージは停止し、先に修正すべき内容を伝えます（たとえば、メインのチェックアウトの変更をコミットまたはスタッシュする）。 マージで競合が発生した場合は自動的に中止され、ダイアログに競合したファイルが一覧表示されます。手動で解決してから、再度 main にマージを実行してください。

​

ワークツリーを削除する

ワークツリードロップダウンを開き、ワークツリーを削除を選びます。これはワークツリーのディレクトリを削除しますが、その git ブランチは保持します。 ワークツリーにコミットされていない変更がある場合、最初の試行は警告とともにブロックされます。変更を破棄して削除で再度確認すると、強制的に削除され、それらの変更は失われます。

​

孤立したワークツリー

ワークツリーのディレクトリが別のウィンドウから、または CTOR の外で削除されると、チャットはチェックアウトがもう存在しないことを検出して読み取り専用になり、「このワークツリーはディスク上に存在しません。チャットは読み取り専用です。」というバナーを表示します。会話は読める状態のままです。作業を続けるには別のチャットに切り替えてください。