タスク一覧 | AGI Cockpit公式ドキュメント

タスク一覧は、複数の仕事から「次にどれを見るか」を選ぶ場所です。個々の会話や追加入力はタスク詳細で扱います。

Desktopの3列構成とオーバービュー

Desktopのタスク画面は、タスク一覧、選択したタスクの作業エリア、必要な操作パネルを横に並べます。タスク一覧は幅を変更したり折りたたんだりでき、操作パネルを閉じると作業エリアを広く使えます。

領域	主な役割
タスク一覧	稼働中の仕事を表示し、重要度、ステータス、作成順、更新順で並べ替える
作業エリア	選択したタスクの会話、進捗、確認要求、入力欄を表示する
操作パネル	ファイル、差分、ブラウザー、App Surface、ターミナルなどを表示する

オーバービューは、タスク、プロジェクト、エージェントを横断検索し、完了済みを含む全体を確認する画面です。タスク一覧ではエージェントで絞り込み、タスクまたはプロジェクトをピン留めできます。別のタスクを選択しても、それぞれの処理は独立して進みます。

検索、並べ替え、メニュー

タスク一覧内の検索は、表示中のタスク名とプロジェクト名へ部分一致します。タスクIDは4文字以上を入力した場合だけ部分一致の対象になります。この検索では、指示本文、作業ディレクトリ、内部メタデータは対象になりません。

DesktopでCommand/Ctrl+Kを押すと、プロジェクトを横断する検索パレットが開きます。タスク名、指示の先頭行、プロジェクト名に加え、「新しいタスク」「設定」「エージェント設定」「Ask通知」「Hooks」「表示」「リモートアクセス」「自動実行タスク」「履歴」「Fleet一覧」「公式ドキュメント」「更新」などのアプリ画面も検索できます。完了済みタスクを含む候補から↑↓で選び、Enterで移動、Escapeで閉じます。検索語が空の場合は、最近のタスクと主要な画面を表示します。既定のキーは設定の「ショートカット」で変更できます。

タスク行と子タスク一覧の「…」メニューでは、名前変更、ピン留めまたは解除、完了、タスクIDのコピー、削除を行えます。子タスクでは親からの切り離しも選べます。名前はEnterで確定、Escapeで取り消し、空の名前は保存されません。上限は50文字です。

プロジェクト見出しのメニューでは、そのプロジェクトに属する未完了タスクをまとめて完了にするか、タスクをすべて削除できます。一括完了では実行中のタスクと確認待ちのFleetタスクが既定で対象外になり、必要な場合だけ明示的に含めます。一括削除は完了済みに限らず、実行中のタスクも含めてそのプロジェクトのタスクをすべて削除します。確認画面は、実行中のタスクがある場合に停止すること、関連するFleet実行がある場合に実行中なら停止することを示します。この操作は取り消せません。

タスク一覧へマウスを重ねている間や、メニュー、名前変更、削除確認の操作中は、自動並べ替えで行が移動しません。操作を終えると現在の状態に基づく順序が反映されます。

件数の多いグループは初期件数だけを表示し、「もっと見る」で段階的に追加します。一度以上展開すると「折りたたむ」が表示され、DesktopとPWAのどちらでも初期件数へ戻せます。

PWAで検索を続ける

PWAのタスク検索では、入力中の検索語を接続先ごとに端末のブラウザーへ保存します。タスク詳細から戻ったときや画面を開き直したときも、同じ検索語で絞り込みを続けられます。

検索欄を選ぶと「最近の検索」が表示され、最大5件から再検索できます。入力中は前方一致する履歴を表示します。Enterまたはキーボードの検索キーで確定した検索や、検索結果からタスクを開いたときの検索が履歴に入ります。

「検索をクリア」は現在の検索語だけを消します。履歴は1件ずつ「履歴から削除」、または「履歴を消去」でまとめて削除できます。履歴の削除だけでは現在の検索語は変わりません。保存はそのブラウザー内だけで、別端末へ同期されません。ブラウザーの保存が利用できない場合は、画面内の検索は使えますが、開き直した後の復元はできません。

アイコンでプロジェクトを見分ける

Desktopのサイドバーとオーバービュー、PWAのプロジェクト一覧には、利用できる場合にプロジェクト固有のアイコンを表示します。プロジェクト内のfaviconなどを自動検出し、見つからない場合は既定のフォルダー表示を使います。

cockpit project icon get --directory <path>で現在のアイコンを確認し、cockpit project icon set <image-path> --directory <path>でローカル画像を指定できます。cockpit project icon reset --directory <path>で自動検出に戻します。変更は保存され、接続中のPWAにも同期されます。プロジェクトはディレクトリ単位のため、worktreeと元のチェックアウトは別のアイコンを持ちます。ネットワークから画像を取得することはありません。形式とサイズ制限はprojectリファレンスを参照してください。

タスクの入口と作業場所

通常の新規タスクは、プロジェクト、永続ディレクトリ、一時ディレクトリ、Git Worktreeを作業場所にできます。永続ディレクトリは~/.agi-tools/workspacesへ保存され、一時ディレクトリはタスク完了時に削除されます。

Quick Taskはグローバルショートカットから小さな作成ウィンドウを開き、現在のアプリ画面を離れずにタスクを投入する入口です。作成後は通常のタスク一覧とタスク詳細で監督します。

Git Worktreeは変更を別checkoutへ分離しますが、同じブランチを複数のWorktreeで同時にcheckoutできません。Desktopで完了するとWorktreeを維持します。cockpit task complete <id>は既定でWorktreeを削除し、--keep-worktreeを付けた場合だけ維持します。

タスク状態を読む

状態	意味	次の確認
実行中 (`running`)	エージェントまたはコマンドが処理中	進捗を読み、必要な場合だけ割り込む
確認待ち (`waiting_confirmation`)	応答終了、質問、権限待ちなど	待機理由を確認して返信または判断を返す
完了 (`completed`)	利用者が仕事全体を完了にした	必要な成果が保存されているか確認する
エラー (`error`)	起動または実行開始に失敗した	タスク詳細の理由を確認する

「確認待ち」では、turn_complete、permission、question、terminal_prompt、runtime_error、usage_limit、idle_timeout、unknownの待機理由を区別します。turn_completeは1回の応答が終わった状態で、タスク全体の完了ではありません。

needsResumeも状態名ではありません。未完了のタスクが実行プロセスを失い、保存済みセッションへ再接続する必要があることを表します。

Fleet Runを見分ける

タイトル付きFleet Runは、タスク一覧のFleetグループとFleet詳細にタイトルを表示します。各ノードタスクの名前は「Runタイトル / ノード名」になり、通常のタスク名と同じ方法で検索できます。

Fleetグループの実行表示とステータス順はRun全体の状態に従います。エージェントタスクが一時的に0件でも、command gateまたはhuman gateを評価中のRunはDesktopとPWAで実行中のまま表示されます。

Runの「Runを削除」は保存済みRun履歴だけを削除し、関連タスクを残します。「Runとすべてのタスクを削除」は確認画面に表示された関連タスクも削除します。後者は元に戻せないため、必要な成果を保存してから実行してください。

完了と削除

「完了」はタスクを稼働中の仕事から完了済みへ移します。「削除」はCockpitからタスク記録を取り除きます。別の操作です。

保存済みタスクがある場合、AGI Cockpitは最後のタスクを明示的に削除しない限り、空のタスク一覧で既存データを上書きしません。起動時にstate.jsonを読めない場合も書き込み前に停止し、データフォルダーと隣接するbackupsからの復旧手順を表示します。

CLIで一覧と状態を確認する

cockpit task list
cockpit task get <id>
cockpit task complete <id> --keep-worktree

task getはstatus、waitingReason、readyForNextPrompt、needsResumeと、最新の会話・ターミナル出力を返します。