herdr

Control Herdr terminal multiplexer panes, tabs, and workspaces to manage coding agents.

9|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/Yassimba/loom --skill herdr-yassimba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: herdr
Source: https://github.com/Yassimba/loom/tree/main/skills/herdr
Command: npx skills add https://github.com/Yassimba/loom --skill herdr-yassimba

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple coding agents, shells, and long-running commands across terminals is chaotic without a structured control surface. This Skill lets an agent inspect and control Herdr workspaces, tabs, and panes through the herdr CLI, so it can spawn agents, run commands, read output, and wait for state changes programmatically. ## Core Features & Use Cases - Pane and workspace control: List, split, rename, and organize panes, tabs, and workspaces using stable public IDs parsed from JSON responses. - Agent lifecycle management: Start interactive agents (Codex, Claude Code, pi, OpenCode, OMP) in sibling panes, submit prompts, and wait on agent_status transitions like idle, working, blocked, or done. - Command execution and output reading: Run ordinary commands in other panes, wait for matching output, and read scrollback via visible, recent, recent-unwrapped, or detection sources. - Use Case: While working on a feature, ask your agent to open a reviewer agent in a side pane, have it review the current diff, and report actionable findings without leaving your session. ## Quick Start Use the herdr skill to split my current pane and start a Codex agent that reviews the current diff.

Frequently Asked Questions about herdr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Herdr panes from a coding agent?

Verify HERDR_ENV equals 1, then use the herdr CLI to list, split, and run commands in panes. Parse pane IDs from JSON responses and use --current or explicit IDs rather than relying on the focused pane.

How do I start another coding agent in a Herdr pane?

Split the current pane with herdr pane split --current --direction right --no-focus, then run the agent's normal executable such as codex, claude, pi, or opencode. Wait for agent_status to become idle before submitting the task with pane run.

What is the difference between idle and done agent status in Herdr?

Both mean the agent finished or is waiting; idle means the result is considered seen, while done means it completed unseen in a background tab or workspace. Focusing the pane converts done to idle.

Does the Herdr skill work outside a Herdr session?

No. The skill first checks that HERDR_ENV equals 1; if the agent is not running inside a Herdr-managed pane, it must stop and report that it is not inside Herdr rather than controlling the session from outside.

Why should I avoid running bare herdr or mutating commands without arguments?

Bare herdr launches or attaches the TUI instead of printing help, and some commands like herdr workspace create execute with defaults when arguments are omitted. Discover syntax via herdr --help and command-group output instead.

Does Herdr work on Windows?

Native Windows is not supported for this skill; the frontmatter specifies wsl. Run Herdr inside WSL2 with an Ubuntu distribution on Windows machines.