herdr

# 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 echo $SHELL; getent passwd $USER | cut -d: -f7 # should be /usr/bin/zsh on this host # swarm's _user_shell() picks: $SHELL -> pwd.getpwuid -> /usr/bin/zsh -> /bin/bash ``` ### 2. Inspect Herdr state for a run ```bash herdr workspace list --json 2>&1 | jq '.[] | {id,name,path,status}' | head -n 40 # Expected: one workspace per run: swarm-20260807T...-<short> # Orphan chec...