agent-send
Skill4 starsChanged 33 days agoMITView on GitHub
Send a prompt to an agent running in a Herdr pane and confirm it landed, or wait until its work is done. Use when handing a task to another session or Codex pane (このセッションに投げて). For other pane operations, use herdr.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- shimo4228/herdr-toolkitword for word, first seen Oct 15, 2026
Other versions1 project uses a version of this.
Word for word · 1
- shimo4228/herdr-toolkit★ 0100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository51 other files it gives its agents.
- llms-full.txtllms.txt
- llms.txtllms.txt
- agent-stocktakeSkill
- author-calibrated-evalSkill
- authorship-strategySkill
- collect-contextSkill
- context-syncSkill
- decision-historySkill
- detail-loopSkill
- generation-auditSkill
- harness-boundarySkill
- harness-stocktakeSkill
- harness-syncSkill
- headline-craftSkill
- hf-syncSkill
- hook-stocktakeSkill
- implementation-chainSkill
- jev-judgment-designSkill
- jsonld-knowledge-graphSkill
- learn-evalSkill
- llm-as-judgeSkill
- llms-txt-writerSkill
- mono-figureSkill
- persona-read-loopSkill
- plugin-directory-submitSkill
- prompt-perturbSkill
- prose-translationSkill
- public-commentSkill
- readme-writerSkill
- release-doiSkill
- repair-disciplineSkill
- repo-asset-stocktakeSkill
- review-to-lintSkill
- rfc-writerSkill
- rules-distillSkill
- rules-stocktakeSkill
- search-firstSkill
- session-judgment-miningSkill
- skill-complySkill
- skill-healthSkill
- skill-stocktakeSkill
- skill-writerSkill
- social-postSkill
- spawn-sessionSkill
- task-stocktakeSkill
- task-triageSkill
- verify-bootstrapSkill
- widen-the-askSkill
- wiki-harvestSkill
- wiki-querySkill
- x-draftSkill
The file
Files
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 の開始を観測した」で判定し、完了は別のコマンドで待つ。
送る
${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 | 期限内に作業が終わらなかった。送っていない |
preflight 失敗（herdr_unreachable / server_down / incompatible / server_too_old） | 5 | Herdr に届かない・止まっている・版ずれ。stderr の理由を人間に渡す |
Enter を自動で押さないのは、blocked の検出が dialog の描画から 0.3 秒ほど遅れ、承認を押しうる ため（herdr #4764）。
終わりを待つ
${CLAUDE_SKILL_DIR}/agent-send.sh wait <target> --timeout 3600000 \
--done-if 'git -C <worktree> log -1 --format=%s | grep -q "<task>"'Bash tool の run_in_background: true で起動する。 終わると通知が届くので、その間に画面を
読みに行かない。
- 完了は、settled（idle か done）が続けて観測されること（Claude は 2 回、他は 3 回。間隔 30 秒）と、
--done-ifの command が真であること - 状態の読み方
- Claude:
claude agents --jsonの status（Claude Code 自身の報告。背景 subagent の実行中、 Herdr のdone中もbusyを返した — 2026-10-10 実測） - それ以外: Herdr の画面検出
- Claude:
- 画面検出には偽の idle がある（背景 subagent の実行中など）。成果物で判定できるときは
--done-ifを付ける- build の完了: commit が branch に現れた
- 画像生成の完了: 出力ファイルがある
- 背景 process の終了:
! pgrep -f '<pattern>'
- exit 0
done: 成果物を読む / 3blocked: 画面を読み、人間に渡す / 4timeout: 画面と成果物を 見て、延長か打ち切りを決める
Herdr の版
agent-send.sh preflight（prompt の前にも自動で走る）は、server と client の互換性が無いとき、
または server が 0.9.0 より古いときに止まる。server が client より古いだけなら警告を出す。
警告と停止の理由は人間に渡す — server の再起動は全 pane の turn を止めるので、時刻は人間が決める
（brew 版は herdr update --handoff を使えず、再起動が要る）。~/.claude/skills/herdr/SKILL.md のコピーが
herdr --skill の出力と違うときも警告する（origin 行を残して置き換える）。
前提
- 宛先は、この session が起こした pane（spawn-session の出力の
herdr:行）か、人間が指名した pane に限る。それ以外の session へは送らない — 人間が操作中の会話に割り込むため - 送信は Herdr への委譲に当たる。委譲してよい条件は環境の境界 rule が決める（著者の環境では
rules/common/boundary.md: 明示指示が要る。spawn-session で自分が起こした pane へはHERDR_ENV=1無しで送ってよく、それ以外の pane へはHERDR_ENV=1も要る） herdr（server 0.9.0 以上）とjq- 宛先が Claude Code のときは
claudeCLI（状態の読み取りに使う） - テスト:
${CLAUDE_SKILL_DIR}/tests/agent-send.bats（偽のherdr/claudeをtests/bin/に置く）
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.