
Herdr
Herdr is for when you're already running inside a Herdr session and want Claude Code to poke at the rest of it. Once `HERDR_ENV=1` is set, the skill lets the agent read panes, tabs, and workspaces, start a shell or another coding agent in a sibling pane, send input, read output, and wait for state changes like idle, blocked, or done. The docs are unusually careful about the sharp edges: pane IDs are opaque and never reused, agent names follow whatever process currently occupies the pane, and `--machine` routes commands to a remote session rather than a local one. It deliberately refuses to fire just because a task could use a background terminal, which is the right call, since most work doesn't need a second pane. Worth installing only if you actually live in Herdr.
- skills.sh installs
- 81.1K
- GitHub stars
- 49.8K
- last updated
- Oct 26, 2026
Install
$ npx -y skills add herdrdev/herdr --skill herdr --agent claude-codeInstalls into .claude/skills of the current project.
Files
Herdr
Herdr organizes terminals into workspaces, tabs, and panes, recognizes coding agents running inside panes, and exposes the current session through the herdr CLI.
Before issuing any control command, verify that this agent is running inside a Herdr-managed pane:
test "${HERDR_ENV:-}" = 1
If the check fails, say that you are not running inside Herdr and stop. Do not inspect or control the focused Herdr session from outside Herdr.
When the check passes, the herdr binary in PATH talks to the current session. Use it to inspect neighboring work, create terminal layout, start agents and commands, read output, and wait for state changes.
Learn the current CLI
The installed binary is the authority for command syntax. Start with:
herdr --help
Then print the relevant command group by running the group without a subcommand:
herdr agent
herdr pane
herdr workspace
herdr tab
herdr worktree
herdr terminal
herdr notification
herdr integration
herdr session
herdr machine
Sponsors
Details
- Repository
- github.com/herdrdev/herdr
- Categories
- AI & Agent Building, Automation & Workflows, CLI & Terminal
- First seen
- Oct 26, 2026