プロジェクト（コーディングコックピット）

コーディング作業のための「プロジェクト」機能の概要。コードベースをプロジェクトとして登録すると、チャットのサイドバーから一覧・切り替えができ、色分けや worktree 操作、バックグラウンド実行の可視化なども行える（後述の「プロジェクトの便利機能」）。

確認状況

プロジェクト操作の一部の画面文言は英語表示の場合がある。

プロジェクトとは

コードベースでの作業は ワークスペース の指定とチャット内のツール実行にも頼れるが、コードベースをプロジェクトとして登録すると、チャットのサイドバーから一覧・切り替えできる。

• プロジェクトサイドバー: チャットサイドバーにプロジェクトの管理が組み込まれ、プロファイルごとにコードベースを一覧・切り替えできる。プロジェクトを作っていない既定状態では専用セクションは表示されない。作成は Cmd+K パレットのプロジェクトコマンド（作成・フォルダ追加・プロジェクト概要の生成）から始める。
• 階層モデル: プロジェクト → リポジトリ → レーン の階層。1 つのプロジェクトが複数リポジトリ・複数 worktree にまたがれる。
• セッションのグループ化: プロジェクトに属するセッションが、リポジトリ・worktree を横断してプロジェクト単位にまとまる。アーカイブから復元したセッションもプロジェクトのツリーへ戻る。
• git worktree 管理: プロジェクト内のリポジトリごとに worktree を検出・管理する（内部では git worktree list を並列に照会する）。

主な構成要素

要素	内容
プロジェクト操作	プロジェクトの作成、フォルダの追加、プロジェクト概要（IDEA.md）の生成。Cmd+K パレットからも操作できる
ターミナルパネル	右サイドバーに複数ターミナルを開ける。タブとスクロールバックは再起動後も復元される。エージェントが使うターミナルは読み取り専用で観察できる
プレビューペーン	右レールのプレビューでファイルの中身と変更（diff）を確認できる。チャット内には PR スタイルのファイル diff が表示される
リッチ埋め込み	アシスタントの Markdown に図・アラートなどのリッチ埋め込みをインライン表示する

リモートゲートウェイのエージェントに対しても、フォルダピッカーと git 連携が機能する（ローカル専用ではない）。

プロジェクトの便利機能

プロジェクト機能には、次のような操作・表示がある。

セッションとプロジェクトのカラー

プロジェクトに色を設定すると、そのプロジェクトに属するセッションが色を継承し、サイドバーのセッション行とペーンのタブが同じ色で表示される（両者は同じ解決結果を参照するためズレない）。セッション単位での上書きもできる。

• プロジェクトの色: プロジェクト行のメニューの「外観」から色を選ぶ。「色なし」で解除する。
• セッションの色の上書き: セッション行のメニューの「外観」から色を選ぶ。「色なし」を選ぶとプロジェクトから継承した色に戻る。
• 優先順位: セッション単位の上書きが最優先で、未設定ならプロジェクトの色を継承する。色を設定していないプロジェクト（自動検出されたリポジトリを含む）では、セッションに色は付かない（継承は「プロジェクトに色を付けたときだけ」働くオプトイン）。
• 待機中のセッション行の小さなドットにもプロジェクトの色が反映される。実行中・入力待ちなど注意を促す状態のドットは、色分けの意味を保つため専用色のままとなる。

バックグラウンド実行の可視化

• バックグラウンドで進めていたセッションのターンが完了すると、サイドバーのセッション行に緑のドット（「完了 — 未読」）が付く。そのセッションを開くまで表示され、未読の完了を見落としにくくなる。
• LLM のターンが待機中でも、バックグラウンドのターミナルプロセスが動いている間は、セッション行に灰色の点滅ドット（「バックグラウンドタスク実行中」）が表示される。

worktree 操作

• worktree の作成と既存ブランチの変換は、1 つの共有ダイアログ（「新しいワークツリー」／「ブランチを変換」）で行う。
• 新規 worktree の作成時には分岐元ブランチのピッカーが使える。ブランチ名の入力に加えて「（ブランチ名）から分岐」のピッカーを開き、「ブランチを検索…」で分岐元を検索して選べる。
• git リポジトリ内のセッションでは、キーボードショートカット Cmd+Shift+B（Windows/Linux は Ctrl+Shift+B）でこのダイアログを直接開ける。

ステータスバーのワークスペース表示

• ステータスバーには現在のワークスペースの項目があり、アクティブなプロジェクト名（プロジェクトに属さない場合は作業ディレクトリのフォルダ名）を表示する。ホバーで実際の作業ディレクトリのフルパスを確認できる。
• この項目のメニューから「パスをコピー」「格納フォルダーを開く」「ファイルツリーで表示」を実行できる。
• チャット画面でのアクティブプロジェクトの扱いは統一されており、ステータスバーの表示はサイドバーのプロジェクトのグループ分けと同じ判定（バックエンドのプロジェクト情報）に基づく。

リポジトリ自動検出の制御

ローカルフォルダを走査して Git リポジトリをプロジェクトサイドバーに表示する自動検出は、設定で制御できる。desktop.repo_scan_enabled（検出のオン・オフ、既定はオン）、desktop.repo_scan_roots（検索対象フォルダ、空ならホームディレクトリを対象とした範囲限定スキャン）、desktop.repo_scan_exclude_paths（除外パス）の 3 項目で調整する。GUI での設定手順は ワークスペース を参照。

関連する既存機能との関係

• ワークスペース設定: エージェントが読み書きする作業ディレクトリの考え方は ワークスペース を参照。プロジェクトはその上に載る「複数コードベースの管理と専用 UI」にあたる。
• バックアップ: 更新前スナップショットにプロジェクトのデータベース（projects.db）が含まれる。
• サブエージェントの観戦: バックグラウンドで委譲した作業は、読み取り専用のスペクテータートランスクリプトでも追える。

失敗時の確認先

• プロジェクト機能が見当たらない場合は、まず 情報 でバージョンが v0.18.0 以上かを確認する。
• 更新しても表示が変わらない場合は、アプリを完全終了して開き直す（機能追加後の再起動が必要な場合がある）。
• 製品側の変更経緯は 変更履歴 を参照。