Skip to content

herdr

plugin-herdr — Served by plugin-herdr
plugin-herdr — Placement runtime (out-of-process over gRPC)
plugin-herdr — Version 2026.245.1000
plugin-herdr — Served by plugin-herdr
plugin-herdr — Placement runtime (out-of-process over gRPC)
plugin-herdr — Version 2026.245.1000

herdr is a command word served by 2 plugin candies — plugin-herdr and plugin-herdr — at different points in the command tree. Both are real invocations; charly --help prints which is which.

The ‘charly herdr’ CLI for a Herdr terminal-multiplexer session (herdr.dev) PLUS the declarative herdr: check verb — a command:herdr + verb:herdr plugin (an out-of-tree external plugin — composed into projects via the @github.com/opencharly/plugin-herdr/candy/plugin-herdr candy ref and connected out-of-process by word at runtime; no charly-module import). ‘charly herdr status’ pings the target and summarizes workspaces/tabs/panes/agents; workspace/tab/pane helpers list, create, split, run commands, read output, and wait for matching output; agent helpers list, get, wait, prompt, and report lifecycle state. The herdr: check verb is the declarative venue-probe counterpart: authored as a check: step (herdr: ping, workspace-list, pane-wait-output, …), it resolves the in-venue herdr socket-bridge port to a host-routable address over the reverse channel and probes with the SAME NDJSON socket client the command uses (R3 — one protocol surface covers the CLI and every bed). No upstream herdr binary is needed: the plugin speaks the herdr socket API directly (newline-delimited JSON over the session socket; herdr api schema --json is the contract). Session targeting honors the herdr agent-skill safety boundary: the focused session is off-limits from outside unless HERDR_ENV=1, –focused, or an explicit –session/–endpoint target is given.

The ‘charly herdr’ CLI for a Herdr terminal-multiplexer session (herdr.dev) PLUS the declarative herdr: check verb — a command:herdr + verb:herdr plugin (an out-of-tree external plugin — composed into projects via the @github.com/opencharly/plugin-herdr/candy/plugin-herdr candy ref and connected out-of-process by word at runtime; no charly-module import). ‘charly herdr status’ pings the target and summarizes workspaces/tabs/panes/agents; workspace/tab/pane helpers list, create, split, run commands, read output, and wait for matching output; agent helpers list, get, wait, prompt, and report lifecycle state. The herdr: check verb is the declarative venue-probe counterpart: authored as a check: step (herdr: ping, workspace-list, pane-wait-output, …), it resolves the in-venue herdr socket-bridge port to a host-routable address over the reverse channel and probes with the SAME NDJSON socket client the command uses (R3 — one protocol surface covers the CLI and every bed). No upstream herdr binary is needed: the plugin speaks the herdr socket API directly (newline-delimited JSON over the session socket; herdr api schema --json is the contract). Session targeting honors the herdr agent-skill safety boundary: the focused session is off-limits from outside unless HERDR_ENV=1, –focused, or an explicit –session/–endpoint target is given.

charly --help prints the command tree, including where each herdr is invoked and under which parent.