herdr

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

2|Updated Jan 2, 2026
One-click install
npx skills add https://github.com/ShineBreaker/Guix-configs --skill herdr-shinebreaker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: herdr
Source: https://github.com/ShineBreaker/Guix-configs/tree/main/dotfiles/mutable/agents/skills/.config/agents/skills/herdr
Command: npx skills add https://github.com/ShineBreaker/Guix-configs --skill herdr-shinebreaker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple coding agents, shells, and background commands across terminals is error-prone without a stable control surface. This Skill lets an agent inspect and control Herdr-managed workspaces, tabs, and panes through the herdr CLI, so it can spawn agents, send prompts, read output, and wait for status changes reliably. ## Core Features & Use Cases - Pane-based agent control: Split panes, launch interactive agents (Codex, Claude Code, pi, OpenCode, OMP), submit prompts, and read transcripts using stable pane IDs. - State-aware waiting: Wait on agent status transitions (idle, working, blocked, done) or output matches before reading results, with timeout handling. - Topology and safety rules: Discover workspaces, tabs, and worktrees via JSON responses, keep user focus intact with --no-focus, and avoid destructive operations on sessions you did not create. - Use Case: While working in a Herdr session, ask the agent to spin up a reviewer agent in a sibling pane, wait for it to finish in the background, and report its findings without leaving your current pane. ## Quick Start Ask the agent to use Herdr to open a reviewer agent in a new pane and have it review 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 coding agents running in terminal panes?▼

Use the herdr CLI to split a pane, launch the agent's interactive executable, and submit prompts with herdr pane run. The pane ID is the stable control target for spawning, input, reads, waits, and cleanup.

How to run a background command in another terminal pane?▼

Split the current pane with herdr pane split --current --no-focus, then run the command with herdr pane run on the returned pane ID. Wait for expected output with herdr wait output and read results using herdr pane read.

What do idle and done agent statuses mean in Herdr?▼

Both mean the agent finished or is waiting; the difference is attention state. Idle means the result is considered seen, while done means the agent completed in a background tab or workspace and the result has not been viewed yet.

Why does the Herdr skill refuse to run commands?▼

The skill first checks that HERDR_ENV equals 1, confirming the agent runs inside a Herdr-managed pane. If the check fails, it stops rather than inspecting or controlling a Herdr session from outside.

Can I use Herdr pane IDs from workspace or display numbers?▼

No. Public IDs like w1:p1 are opaque strings that must be parsed from JSON responses of create, split, move, list, or get commands. Closed IDs are never reused, and moved panes receive new IDs.