herdrlisted
Install: claude install-skill mifunedev/openharness
# Herdr CLI
Herdr (`herdr`, v0.7.4 in this image) is Open Harness's primary interactive
workspace: a server process plus attached clients, with workspaces → tabs →
panes, and agent-state detection per pane. This skill covers driving it from a
non-interactive agent run. Operator-facing setup, persistence volumes, and the
attach story live in `.oh/docs/integrations/herdr.md` — do not duplicate them
here.
Full subcommand catalog: `references/command-map.md`. Read it when you need a
flag you do not already know; `herdr <group> --help` is the ground truth and
prints a usage block for every group.
## Never do these from an agent run
- **Do not run bare `herdr`, `herdr agent attach`, or `herdr session attach`.**
They take over the terminal and hijack the operator's client. Use
`herdr agent read` / `herdr pane read` to observe instead.
- **Do not run `herdr update` or `herdr channel set`.** Herdr is pinned in the
Open Harness image; upgrade by rebuilding against a reviewed release.
- **Do not run `herdr server stop`.** It kills every attached client. Only the
operator decides that.
- **Do not read or write `~/.config/herdr/`** (config.toml, logs, `herdr.sock`).
A `.config` path segment is denied to agent tooling repo-wide. Use
`herdr config check` and `herdr status`, which report the same facts.
- **Do not close, kill, or send text to a pane you did not create** without the
operator asking. Other panes hold live agents mid-task.
## Output contract
Socket-API-backe