← /teach Study Portal (herdr) に戻る /teach lesson

herdr agent automation クイックリファレンス

随時更新

レイアウト操作

コマンド	説明	返り値 (jq path)
`herdr workspace create --cwd DIR --label NAME --no-focus`	ワークスペース作成（tab + root paneも作られる）	`.result.root_pane.pane_id`
`herdr tab create --no-focus`	タブ作成（root paneも作られる）	`.result.root_pane.pane_id`
`herdr pane split PANE_ID --direction right\|down --no-focus`	既存Paneの横 or 下に分割	`.result.pane.pane_id`

Pane操作（生ターミナル）

コマンド	説明
`herdr pane run PANE_ID "COMMAND"`	コマンドを実行 (Enter付き)
`herdr pane send-text PANE_ID "TEXT"`	テキスト送信 (Enter無し)
`herdr pane send-keys PANE_ID KEY...`	キー送信 (ctrl+c, esc等)
`herdr pane read PANE_ID --source recent --lines N`	ターミナル出力を読む
`herdr pane wait-output PANE_ID --regex "PATTERN" --timeout MS`	出力を待つ
`herdr pane focus PANE_ID`	フォーカスを移す

Agent操作（ライフサイクル制御）

コマンド	説明
`herdr agent start NAME --kind KIND --pane PANE_ID [-- ARGS...]`	Paneにエージェント起動
`herdr agent prompt NAME "TEXT" [--wait] [--timeout MS]`	プロンプト送信
`herdr agent wait NAME --until STATE [--timeout MS]`	状態を待つ
`herdr agent read NAME --source recent-unwrapped --lines N`	出力を読む
`herdr agent list`	全エージェント一覧
`herdr agent get NAME\|PANE_ID`	エージェント詳細
`herdr agent rename PANE_ID NEW_NAME`	名前変更
`herdr agent send-keys NAME KEY...`	UIにキー送信
`herdr agent focus NAME`	フォーカスを移す

エージェントのステート

状態	意味
`working`	作業中
`idle`	入力待ち（タブがフォーカスされた状態）
`done`	入力待ち（バックグラウンドで完了、タブ未フォーカス）
`blocked`	承認待ちや質問UIが表示されている
`unknown`	エージェントは存在するが状態不明

サポートされる --kind

pi, claude, codex, gemini, cursor, devin, agy, cline, omp, mastracode, opencode, copilot, kimi, kiro, droid, amp, grok, hermes, kilo, qodercli, qwen, maki

よく使うパターン

# ① 分割 → 起動 → プロンプト → 待機 → 読取
$ split=$(herdr pane split --current --direction right --no-focus)
$ pane=$(printf '%s\n' "$split" | jq -r '.result.pane.pane_id')
$ herdr agent start helper --kind agy --pane "$pane"
$ herdr agent prompt helper "READMEを読んで要約して" --wait --timeout 120000
$ herdr agent read helper --source recent-unwrapped --lines 80