herdr エージェント・オーケストレーション詳細リファレンス

親エージェント（pi等）がスクリプトやツール経由で子エージェントを自律制御する際の手順と主要コマンド集です。

1. 典型的な制御ライフサイクル

1. ペイン分割: herdr pane split --current --direction right --no-focus
2. エージェント起動: herdr agent start <name> --kind pi --pane <PANE_ID>
3. タスク投入＆待機: herdr agent prompt <name> "<task prompt>" --wait --timeout 120000
4. 出力取得: herdr agent read <name> --source recent-unwrapped --lines 100
5. クリーンアップ: herdr pane close <PANE_ID> または herdr agent send-keys <name> ctrl+c

2. herdr agent コマンド詳細

コマンド	オプション・用例	効果・解説
herdr agent start	--kind <pi|codex|agy|claude|copilot> --pane <id>	対象ペインでエージェントプロセスを起動し、初期対話受付状態になるまで同期待機する。
herdr agent prompt	<name> "<text>" --wait [--timeout MS]	テキストを投入し、Enterを送信。--wait を付けると idle/done/blocked まで完了監視する。
herdr agent wait	<name> [--until blocked] [--timeout MS]	非同期で投入した処理や承認待ちダイアログの検知を待機する。
herdr agent read	<name> --source recent-unwrapped --lines N	端末出力を取得。recent-unwrapped はソフトラップを連結するためログやコードの取得に最適。
herdr agent send-keys	<name> ctrl+c / esc / enter	割り込みやダイアログのキャンセルを安全に送信。

3. 状態管理（State Machine）

• working: エージェントがツール実行中または思考中。
• idle / done: 処理が完了し、次のプロンプトを受け付けられる状態。
• blocked: ユーザーへの確認・承認プロンプト（Yes/NoやTool Approval）で停止中。