pi-coding-agent & herdr クイックリファレンス

オーケストレーション運用で即座に参照するためのコマンド・オプション一覧です。

1. pi-coding-agent (pi) 主要コマンド

操作	コマンド例	説明
対話起動	pi	通常のインタラクティブTUIセッション開始
初期プロンプト付き対話	pi "コードを解析して"	質問を投げた状態でTUIセッション開始
非対話ワンショット実行	pi -p "タスク実行"	TUIを開かず完了後に標準出力して終了
セッション継続	pi --continue "続きの質問"	直前のセッション履歴を引き継ぐ
セッション名指定	pi --name "exp-analysis"	指定した名前でセッションを保存・管理
モデル指定	pi --model gemini-2.5-pro	利用するLLMモデルを指定
思考レベル制御	pi --thinking high "複雑な課題"	off, low, medium, high, max等を指定
ツール制限 (ReadOnly)	pi --tools read,grep,find,ls	ファイル変更やbash実行を封じた安全起動

2. herdr ペイン & エージェント操作

操作	コマンド例	説明
環境確認	herdr status / herdr agent list	サーバ状態や稼働中エージェントの確認
ペイン分割 (右)	herdr pane split --current --direction right --no-focus	現在位置を維持したまま右側に新ペイン作成
ペイン分割 (下)	herdr pane split --current --direction down --no-focus	現在位置を維持したまま下側に新ペイン作成
エージェント登録・起動	herdr agent start sub1 --kind pi --pane <PANE_ID>	対象ペインでpi等をエージェントとして起動
プロンプト投入＆完了待ち	herdr agent prompt sub1 "タスク" --wait	入力を送り、idleまたはdoneになるまで待機
状態取得	herdr agent get sub1	エージェントの現在状態 (idle, working, blocked)
出力取得	herdr agent read sub1 --source recent-unwrapped --lines 50	直近のターミナル出力テキストを取得
キー送信	herdr agent send-keys sub1 ctrl+c	Ctrl+CやEscなどの制御キーを送信