Herdr Launch Cc

---
name: herdr-launch-cc
description: Herdrの指定workspaceに新しいtab（明示指定時はpane分割）を作り、fish -c "cc" でClaude Codeを起動してremote controlのセッションURLを取得・報告する。使用タイミング: (1) /herdr-launch-cc 実行時、(2) 「discordのworkspaceでccを立ち上げて」等、Herdr上でのClaude Code新規起動依頼時。境界: 既存pane・agentの確認や入力送信などの汎用Herdr操作は herdr スキル。HERDR_ENV=1 必須。
---

# 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不要の例外に該当する

## 前提チェック

```bash
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（デフォルト）:**

```bash
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起動

```bash
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にかかる）:

```bash
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>]` を使う