skills.rest
ryuya-matsunawa
ryuya-matsunawaCOMMUNITY
Explore all skills by this author →
GitHub

herdr

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

Updated Sep 16, 2022
Search Tags:#cli#agent orchestration#workspace#pane management#terminal multiplexer#coding agents#herdr
One-click install
npx skills add https://github.com/ryuya-matsunawa/dotfiles --skill herdr-ryuya-matsunawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: herdr
Source: https://github.com/ryuya-matsunawa/dotfiles/tree/main/agents/.agents/skills/herdr
Command: npx skills add https://github.com/ryuya-matsunawa/dotfiles --skill herdr-ryuya-matsunawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple coding agents and terminal processes across workspaces, tabs, and panes is error-prone when done manually. This Skill lets an agent inspect and control a Herdr session programmatically, so it can split panes, start agents, send prompts, and read output without guessing IDs or disrupting the user's focus. ## Core Features & Use Cases - Session Discovery: List workspaces, tabs, panes, and live agents, reading stable IDs from JSON responses instead of predicting them. - Agent Orchestration: Start recognized coding agents in available shell panes, submit prompts with lifecycle-aware waits, and send keystrokes to interactive agent UIs. - Command Execution: Run ordinary commands in sibling panes, wait for matching output, and read transcripts using viewport, recent, or unwrapped sources. - Use Case: While working in a Herdr pane, ask the agent to spin up a reviewer agent in a right-hand split, prompt it to review the current diff, and report back actionable findings. ## Quick Start Ask the agent to verify it is running inside Herdr and then start a reviewer agent in a new pane to the right to 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 command groups such as herdr pane, herdr agent, herdr workspace, and herdr tab. Run herdr --help first, then print each group without a subcommand to learn the installed syntax, and parse IDs from the JSON responses.

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

Split a sibling pane with herdr pane split --current --direction right --cwd "$PWD" --no-focus, read the new pane ID from .result.pane.pane_id, then run herdr agent start <name> --kind <kind> --pane <pane-id>. The pane must be an available shell at its interactive prompt.

Can I use this Skill outside a Herdr session?▼

No. The Skill requires HERDR_ENV=1, which Herdr injects only into managed panes. If the check test "${HERDR_ENV:-}" = 1 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 sitting 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; do not blindly resubmit the prompt.

Why does pane read not show the full agent response?▼

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 full response as Markdown to a temporary file and read that file directly.

Related Skills

Explore More Software Engineering Skills→
blalorblalor

herdr

Controls Herdr panes, tabs, workspaces, and coding-agent sessions via the installed CLI.

Community
Intermediate
seshxnseshxn

swarm-code-review

Coordinate multi-lane code reviews by specialist agents and aggregate findings into a prioritized report.

Community
Advanced
wimpysworldwimpysworld
716

herdr

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

Official
Advanced
kngender5kngender5

dmux-multi-agent

Orchestrate parallel Hermes agents with dmux and tmux session management.

Community
Advanced