agent-sendlisted
Install: claude install-skill shimo4228/claude-harness
# agent-send
Herdr pane で動く agent(Claude Code / Codex など)へ指示を送り、**届いたか**と**終わったか**を
1 行と exit code で返す。script は `${CLAUDE_SKILL_DIR}/agent-send.sh`。
Herdr は turn を追跡せず、agent の状態を画面から検出する。そのため `herdr agent prompt --wait`
(`--until` なし)は turn の**完了**まで待ち、長い作業では `timeout` になる。届いたかどうかは
分からない。agent-send は、届いたかを「turn の開始を観測した」で判定し、完了は別のコマンドで待つ。
## 送る
```bash
${CLAUDE_SKILL_DIR}/agent-send.sh prompt <target> --file packet.md # または --text "…"
```
- `<target>` は agent 名・pane ID・表示名(spawn-session の tab label、例 `AAP/release`)の
どれでもよい。内部で pane ID に固定する
- 相手が working なら終わるまで待ってから送る(既定 10 分、`--busy-timeout MS`)。作業中に送った
指示は queue に入って同じ turn に吸収され、届いたことを証明できない
- 本文は 1 回しか送らない。失敗しても再送しない — `timeout` や `stalled` は「届いていない」の
証拠にならず、再送は二重送信になる
- 例外は `--retry-unseen`(spawn.sh が最初の指示に付ける)。起動直後の未 focus の pane では、指示が
成功を装わずに消えることがある(herdr #4537。2026-10-10 に 0.9.3 の macOS で 2 回中 1 回)。宛先が
Claude Code で transcript がまだ無い(一度もメッセージを処理していない)ときに限り、1 回だけ送り直す
| stdout の `result=` | exit | 意味と次の手 |
|---|---|---|
| `landed`(`via=working` / `seq` / `status` / `transcript`) | 0 | 届いた。完了を待つなら下の wait |
| `accepted via=command` | 0 | `/effort` などの slash command。turn は起きない |
| `typed` | 2 | 本文が入力欄に残り、Enter が入っていない。画面(stderr)を読み、人間の書きかけでなけれ��� `herdr agent send-keys <pane> enter` を自分で判断する |
| `no_evidence` | 2 | 届いた証拠が無い。画面を読んでから決める。再送する前に transcript か画面で本文の有無を見る |
| `not_found` | 2 | 宛先が無い。`herdr agent list` で名前と cwd を確かめる |
| `blocked` | 3 | 承認か質問の dialog で止まっている。画面を読み、人間に渡す |
| `busy` | 4 | 期限内に作業