> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 実行環境

Quest は Local や Worktree などの実行環境をサポートしています。この記事では、各環境の適用シナリオと構成について説明し、タスクを安全かつ効率的に分離して実行できるよう支援します。

| 環境           | 挙動                                                                               | 向いている用途                     |
| :----------- | :------------------------------------------------------------------------------- | :-------------------------- |
| **Local**    | 開いているワークスペースに直接変更を書き込む                                                           | 軽量タスク、迅速な検証                 |
| **Worktree** | メインとは別の [Git worktree](https://git-scm.com/docs/git-worktree) で作業し、適用・マージまで本流と分離 | 中規模、Apply の反復、同一リポジトリで並列タスク |

現在のブランチを汚さず試したいとき、同じリポジトリで複数タスクを並べたいときは [**Worktree**](#worktree) が向きます。

**既定**: Git リポジトリがあると 3 環境すべて。ない場合は **Local** のみ。

<Note>プランが許す範囲で並列タスクをサポートします。</Note>

## Worktree

Worktree モードは Git worktree に基づいてバックグラウンドで独立したワークスペースのコピーを作成し、Agent が隔離された環境でタスクを実行できるようにします。メインのワークスペースはクリーンに保たれ、複数の Worktree を並行して実行できるため、複数の作業を同時に進める必要があるシナリオに適しています。

### コア機能

* **マルチワークスペースの並行処理**: 同じリポジトリ上で複数の Agent を同時に起動できます。各 Agent は独立したファイルビューと変更スペースを持ち、互いに干渉しません。バックグラウンドで複雑なリファクタリングを実行している間も、メインのワークスペースで新機能のコーディングを続けることができます。
* **ローカルブランチに基づく作成**: 作成時に任意のローカルブランチを起点として選択でき、独立したブランチで変更を検証してからメインブランチにマージできます。
* **自動環境初期化**: Worktree を選択してメッセージを送信すると、Agent は依存関係を検出し、一般的な環境セットアップ手順を実行してからタスクの実行に入ります。
* **変更の隔離**: Agent の Files パネルには、メインワークスペースのルートではなく、現在の Worktree ディレクトリの構造が表示されます。反復によって生じた変更は、確認されるまでメインブランチから隔離され、メインのチェックアウトを汚染することなく複数回 Apply できます。

### 適用シナリオ

| シナリオ               | 説明                                               |
| ------------------ | ------------------------------------------------ |
| **並列マルチタスク**       | 複数の要件やリファクタリングを同時に処理し、各トラックを独立して進める              |
| **ブランチレベルの実験**     | feature ブランチに基づいて Worktree を作成し、独立して反復およびテストする   |
| **メインブランチをきれいに保つ** | 複数回の Apply と調整が必要な中規模のタスクで、Worktree を使用してリスクを抑える |

### 使用方法

1. チャットパネル上部の実行環境エリアで、現在のモード（「Local」など）をクリックします。
2. ドロップダウンから **Worktree** モードを選択します。
3. モードセレクターの横にあるブランチドロップダウンで、Agent が Worktree を作成する際の起点となるローカルブランチを選択します。

**起動スクリプトの構成**
Worktree の作成時に初期化操作を自動的に実行する必要がある場合は、設定の「ローカルタスクの Worktree 設定」で起動スクリプトを編集できます。