Herdr Launch CC

Herdrの指定workspaceに新しいtab（明示指定時はpane分割）を作成し、fish -c "cc" でClaude Codeを起動し、remote control（デフォルト有効）のセッションURLを取得して報告する。

既存設定との関係

• herdrスキル: herdr CLIの構文・ID規約・状態モデル（idle/done等）の真実源。本スキルは起動フローの固定手順のみを規定する。コマンドの引数に迷ったら該当コマンドグループ（herdr pane 等、bareの herdr は実行しない）の出力に従う
• worktree運用: Herdr操作は読み書きともCLI経由でありコード編集を伴わないため、worktree不要の例外に該当する

前提チェック

test "${HERDR_ENV:-}" = 1

失敗したらHerdr外で動いている旨を伝えて停止する。

完了基準: HERDR_ENV=1 を確認済み。

Step 1: 配置先の確認

1. herdr workspace list で一覧を取得する
2. workspaceが未指定ならAskUserQuestionで確認する（一覧のlabelとworkspace_idを選択肢にする）

配置方法のデフォルトは新規tabの作成。ユーザーが「paneを分割して」「隣に」等と明示した場合のみpane分割にする（配置方法は質問しない）。

完了基準: workspace_idが確定している。

Step 2: tab / paneの作成

新規tab（デフォルト）:

herdr tab create --workspace <ws_id> --no-focus

JSON応答の result.root_pane.pane_id と result.tab.tab_id を読み取り、herdr tab rename <tab_id> "cc" と herdr pane rename <pane_id> "cc" でラベルを付ける。

pane分割（明示指定時のみ）:

1. herdr pane list --workspace <ws_id> と herdr pane layout --pane <対象pane> でactive tabのpane矩形を確認する
2. 最も大きいpaneを分割対象とし、幅広（width > height×2目安）なら --direction right、縦長・狭幅なら --direction down を選ぶ
3. herdr pane split <pane_id> --direction <right|down> --no-focus を実行し、応答の result.pane.pane_id を読み取って herdr pane rename <pane_id> "cc" する

IDの推測・組み立ては禁止。必ずJSON応答から読む。

完了基準: 新pane_idをJSON応答から取得済み。

Step 3: Claude Code起動

herdr pane run <pane_id> 'fish -c "cc"'
herdr agent wait <pane_id> --until idle --timeout 60000

waitがタイムアウト（exit 1）したら、herdr pane get <pane_id> と herdr pane read <pane_id> --source visible --lines 40 で実際の画面を確認してから判断する（blocked は入力待ち、unknown は未検出）。

完了基準: pane get で agent: claude、agent_status: idle を確認済み。

Step 4: remote controlの確認とURL取得

remote controlはデフォルト有効（有効時はステータスバー右端に /rc インジケータが表示される）。

1. herdr pane read <pane_id> --source visible --lines 40 でステータスバー右端の /rc インジケータを確認する。表示があれば有効化済み
2. /rc を送信し、URL行の出現を待つ（有効化済みならステータスモーダルが開き、未有効なら有効化されて「is active」行が出る。どちらも下記matchに一致する）:

herdr pane run <pane_id> "/rc"
herdr pane wait-output <pane_id> --match "claude.ai/code/session_" --timeout 15000

3. waitの応答の matched_line からセッションURL（https://claude.ai/code/session_...）を控える
4. visibleを読み、「Remote Control」モーダル（Disconnect / Show QR code / Continueの選択肢）が表示されていたら、❯ がContinueにあることを確認して herdr pane send-keys <pane_id> enter で閉じ、再度visibleでプロンプト（❯）復帰を確認する
5. waitがタイムアウトした場合はvisibleを読んで実画面で判断する。「Remote Controlが設定で無効」等を示す場合は、勝手に /config を操作せずユーザーに報告して指示を仰ぐ

完了基準: セッションURLを取得しプロンプト復帰を確認済み、または無効化状態をユーザーに報告済み。

Step 5: 報告

workspace（label + ID）・新pane_id・remote controlのセッションURLを報告する。

Gotchas

• /rc はClaude Code側で /remote-control に展開されて実行される
• herdr pane run はテキストとEnterを一括送信する。起動直後のTUIに送るとテキストが失われるため、必ず idle を待ってから送る
• bare herdr はTUIをattach/起動するため実行しない（discoveryはコマンドグループ出力で行う）
• 応答画面に「N MCP servers need authentication」警告が出ることがある。起動自体は成功なので、報告に含めるだけでよい
• remote controlの有効/無効はステータスバー右端の /rc インジケータで判定する。デフォルト有効なので、通常 /rc 送信は「有効化」ではなくURL表示のステータスモーダルを開く操作になる
• /rc の応答は2形式ある: 未有効→有効化して「is active」の1行表示、有効化済み→URL・QRコード・Continue選択肢のモーダル。待つ文字列は必ず claude.ai/code/session_（両形式にマッチ）にする
• モーダルをContinueで閉じた後に「remote-control is active」の行は表示されない。確認はURL取得＋プロンプト復帰で行う（is active行を待つとタイムアウトする）
• トップレベルの herdr wait ... は存在しない（unknown command: wait になる）。agentの状態待ちは herdr agent wait <target> --until <status> [--timeout <ms>]、pane出力の待ちは herdr pane wait-output <pane_id> --match <pattern> [--timeout <ms>] を使う