skills.rest
leonardoacosta
leonardoacostaCOMMUNITY
Explore all skills by this author →
GitHub

herdr

Control Herdr terminal multiplexer panes, tabs, workspaces, and coding agents via CLI.

Updated Aug 2, 2026
Search Tags:#workflow automation#cli#agent coordination#pane management#terminal multiplexer#coding agents#herdr
One-click install
npx skills add https://github.com/leonardoacosta/agents --skill herdr-leonardoacosta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: herdr
Source: https://github.com/leonardoacosta/agents/tree/main/skills/herdr
Command: npx skills add https://github.com/leonardoacosta/agents --skill herdr-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple coding agents and terminal processes across panes, tabs, and workspaces is error-prone without a structured control interface. This Skill teaches an agent how to safely inspect and control a Herdr terminal multiplexer session through its CLI, avoiding common mistakes like targeting the wrong pane or misreading agent lifecycle states. ## Core Features & Use Cases - Session Discovery: List workspaces, tabs, panes, and live agents, parsing stable IDs from JSON responses instead of guessing them. - Agent Coordination: Start named coding agents in available shell panes, submit prompts with lifecycle-aware waits, and read their output through the agent surface. - Command Execution: Run ordinary commands in sibling panes, wait for matching output, and read logs using the appropriate snapshot source. - Use Case: While working in a Herdr pane, ask the agent to spin up a reviewer agent in a split pane, prompt it to review the current diff, and report back only actionable findings once it reaches an idle state. ## Quick Start Ask the agent to use Herdr to split the current pane, start a reviewer agent, 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 Herdr panes and agents from the CLI?▼

Use the herdr CLI after confirming HERDR_ENV=1 in your environment. Run herdr --help and command groups like herdr pane or herdr agent to learn syntax, then parse stable IDs from JSON responses rather than predicting them.

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

Split a sibling pane with herdr pane split --current --cwd "$PWD" --no-focus, then run herdr agent start with a unique name, kind, and the returned pane ID. The pane must be an available shell at its interactive prompt.

Can I use Herdr commands when not running inside Herdr?▼

No. The Skill requires HERDR_ENV=1, which Herdr injects only into managed panes. If the check fails, the agent must report it is not running inside Herdr and stop rather than control the session from outside.

Why does herdr agent prompt return agent_blocked or agent_prompt_stalled?▼

agent_blocked means the agent is waiting at an approval or question dialog, so inspect it with agent get and agent read before sending input. agent_prompt_stalled means no working or blocked activity was observed within five seconds after submission.

Why can't I read full agent output with herdr pane read?▼

Agents running on the terminal's alternate screen do not write rows into Herdr's host scrollback, so increasing --lines cannot recover them. As a fallback, ask the agent to write its response to a file and read that file directly.

Related Skills

Explore More Software Engineering Skills→
wimpysworldwimpysworld
716

herdr

Control Herdr terminal multiplexer workspaces, panes, and coding agents via CLI.

Official
Advanced
InditexTechInditexTech
195

review

Run parallel sub-agents to review code changes against repository standards and specifications.

Official
Advanced
prthikprthik
1

ultrawork

Execute independent subtasks in parallel across multiple agents.

Community
Advanced
sumik5sumik5
1

operating-herdr

Manage workspaces, tabs, panes, and agents via the herdr CLI.

Community
Intermediate