herdr

Reviewed at commit 03f7155 New version, not yet reviewed

Drive the herdr terminal workspace manager: panes, tabs, workspaces, and sibling coding agents

Made by
Ben Drucker
What we checked

Shows the session's subagent and teammate counts and its git branch as tags on the herdr terminal pane that hosts it, and adds a skill that lets Claude inspect and drive herdr panes, tabs, workspaces and sibling agents. It only acts inside herdr and runs the local herdr program; no network calls of its own. It depends on the dispatch and mod-events plugins.

Review details

Static review of the source at the pinned commit; not run. Full re-review of the plugin (the diff since 57e0f60 was too large for a delta). Registers session.start, turn.start, turn.complete, classic.SubagentStart, classic.SubagentStop, classic.TeammateIdle and session.end. It acts only when HERDR_ENV=1, HERDR_PANE_ID is set and the session is interactive. It then runs '<HERDR_BIN_PATH or herdr> pane report-metadata <pane id> --source bendrucker:herdr --seq N --token name=value ...' with a 3 s timeout (1 s at session end to clear the tokens), carrying subagent and teammate counts, waiting and idle counts and the output of 'git branch --show-current' (1 s timeout). It reads agents with $.agent.list, polls every 10 s only while agents are active, and stops after 3 failed spawns. Events (herdr call results, exit codes, stderr) go through $.modEvents.emit to the mod-events dependency. No fetch, no file access, no model calls. The skill (SKILL.md) pre-approves only read-only herdr, hc and herdr-app subcommands (api snapshot, list, get, read, wait, explain, machine list, --help) and two bang-executed scripts in its own folder: scripts/commands.sh (bash, renders herdr --help output with awk) and scripts/orient.ts (bun, runs 'herdr api snapshot' and 'herdr machine list --json', discards stderr, prints a projection of workspaces, panes, cwd and titles and saved machine labels but not SSH targets). Mutating herdr commands (pane split, run and close, agent start, worktree create, machine-forwarded commands) and launching sibling Claude agents (hc run, wt switch --create) are only described in the prompts, so Claude still asks permission. The prompts tell Claude to close only panes it opened and not to quote SSH targets. The herdr binary, the zod and cleye npm dependencies and the dispatch and mod-events plugins were not reviewed here. The previous dispatch.ts and ledger.ts are removed from this plugin.

What it uses
  • Reads your prompts: no
  • Sees tool calls: no
  • Blocks or changes tool calls: no
  • Reads or writes files: no
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: no
  • Shows something on screen: no
Hooked events
Made this mod? Add a badge to your README

modsforClaude badge for herdr

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/herdr.svg)](https://modsforclaude.com/mods/herdr/)

← All mods