add herdr-cli skill for multi-agent orchestration #21

Merged
jerome merged 1 commit from herdr-cli into main 2026-07-08 01:47:37 +03:00
Collaborator

Goal

Add a herdr-cli skill (mirrors the forgejo-cli plugin layout) documenting
the herdr CLI for an orchestrator Claude session driving multiple agent
panes.

Why

herdr (herdr.dev) is a terminal workspace manager for AI coding agents,
already used locally (see ~/bin/herdr-keepalive.py). No skill existed for
using its CLI to survey, dispatch tasks to, wait on, and message multiple
agent panes from one orchestrator session.

What's in the skill

  • Targets: pane id vs agent name/label resolution across herdr agent * /
    herdr pane * / herdr wait *.
  • Survey: agent list/get/read/explain.
  • Dispatch: agent send + pane send-keys enter vs pane run (text-only
    vs text+Enter).
  • Waiting: agent wait, wait agent-status, wait output --match.
  • Spinning up new agents in isolated worktrees (worktree create +
    agent start).
  • Orchestration recipes: dispatch-to-idle, broadcast nudge, N parallel
    workers on separate worktrees.
  • Footguns: blocked status is overloaded (permission prompt / plan gate /
    usage limit / real question -- always inspect before acting), don't press
    Enter into a working pane, JSON-only output.
## Goal Add a `herdr-cli` skill (mirrors the `forgejo-cli` plugin layout) documenting the `herdr` CLI for an orchestrator Claude session driving multiple agent panes. ## Why herdr (herdr.dev) is a terminal workspace manager for AI coding agents, already used locally (see `~/bin/herdr-keepalive.py`). No skill existed for using its CLI to survey, dispatch tasks to, wait on, and message multiple agent panes from one orchestrator session. ## What's in the skill - Targets: pane id vs agent name/label resolution across `herdr agent *` / `herdr pane *` / `herdr wait *`. - Survey: `agent list/get/read/explain`. - Dispatch: `agent send` + `pane send-keys enter` vs `pane run` (text-only vs text+Enter). - Waiting: `agent wait`, `wait agent-status`, `wait output --match`. - Spinning up new agents in isolated worktrees (`worktree create` + `agent start`). - Orchestration recipes: dispatch-to-idle, broadcast nudge, N parallel workers on separate worktrees. - Footguns: `blocked` status is overloaded (permission prompt / plan gate / usage limit / real question -- always inspect before acting), don't press Enter into a `working` pane, JSON-only output.
feat(herdr-cli): add skill for orchestrating multiple agent panes
All checks were successful
gitleaks / gitleaks (pull_request) Successful in 4s
10a6a74331
Reference for the herdr CLI (herdr.dev): survey/dispatch/wait/comment
primitives for driving several coding-agent panes from one orchestrator
session, plus footguns (blocked-status ambiguity, send vs run, target
resolution).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
claude changed title from feat: add herdr-cli skill for multi-agent orchestration to add herdr-cli skill for multi-agent orchestration 2026-07-08 01:42:07 +03:00
jerome approved these changes 2026-07-08 01:47:33 +03:00
jerome merged commit 0ee5c3dcc5 into main 2026-07-08 01:47:37 +03:00
jerome deleted branch herdr-cli 2026-07-08 01:47:37 +03:00
Sign in to join this conversation.
No reviewers
No milestone
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
public/chiche-plugins!21
No description provided.