Manage Herdr workspaces, tabs, and panes for Agent Toolkit swarms with eager windows, shell-aware.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Herdr
Operate Herdr as the primary UI for `agent-toolkit swarm` — eager tabs, shell-consistent execution (`zsh`/`bash` via `_user_shell()`), and clean reuse of windows. This skill is the Herdr complement to `swarm` and `swarm-observer`.
## When to use
- Swarm was started with `--ui herdr` (default) and you need to inspect or recover Herdr state.
- `herdr workspace list/create/tab create/pane run` behavior is unexpected (extra workspaces `w7-wA` for `headless`, wrong `--cwd`, or missing eager windows).
- User prefers Herdr over tmux for its excellent interactive UX and wants to reuse tabs for sequential requests.
## Prerequisites
- `herdr` CLI installed and daemon running (`herdr --version`, `herdr workspace list --json` works; `--json` may be unsupported on older binaries — fallback to text).
- Swarm run exists: `.agent-toolkit/swarm/runs/<run-id>/state.json` with `ui: herdr`.
- Repo is a Git directory (worktrees are created under `.agent-toolkit/swarm/runs/<run-id>/worktrees/`).
## Workflow
### 1. Verify backend and shell
```bash
agent-toolkit swarm doctor --json | jq '.backends'
herdr --version
…
The line at the top of this page pins the label v1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_fb3jn3kdjcx3rta7
GET https://markdownregistry.com/api/v1/resolve?ref=ulises-jeremias/agent-toolkit/herdr
GET https://markdownregistry.com/api/v1/blob/3bad25c183896186420cbc3fcdf9ad655b3af9c4c65e9b67f0ea5e770d9b4d9a
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/adr/SKILL.md · WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/blast-radius/SKILL.md · Find what a change could break somewhere else before it ships, beyond the diff, and prove
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/brag-slim/SKILL.md · Turn a project directory or a website URL into a short, shareable launch video with music, motion, and share copy. One…
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/brag/SKILL.md · Turn the current project website into a short, polished, shareable launch video using Hyperframes. Use when someone…
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/bug/SKILL.md · WHAT - Draft and review bugs using the Bug Template; classifies whether an issue should be
davidondrej/skills · skills/agent-orchestration/herdr/SKILL.md · Operate and coordinate AI agents in Herdr workspaces in Ghostty. Use when the user mentions Herdr or asks to inspect…
bastani-inc/atomic · packages/subagents/skills/herdr/SKILL.md · Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to…
istin/flutter_agent_harness · docs/integrations/herdr/SKILL.md · Drive the herdr terminal multiplexer from inside fa: report on sibling agent panes, wait until another agent is…
modem-dev/ossrules · public/files/herdr/skills/herdr/SKILL.md · Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to…
sfc-gh-eraigosa/dotfiles · ai/skills/herdr/SKILL.md · Use when the user mentions herdr or is working inside a herdr pane and wants to save/restore a pane layout, change…
bendrucker/claude · plugins/herdr/skills/herdr/SKILL.md · Drive the herdr terminal workspace manager: inspect workspaces, tabs, and panes, hand work to sibling coding agents in…