skills.rest
TrayMachi
TrayMachiCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

herdr

Control herdr workspaces, tabs, and panes via CLI commands over a local unix socket.

Updated Mar 30, 2026
Search Tags:#cli#agent coordination#pane management#terminal multiplexer#workspace automation#unix socket#herdr
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill herdr-traymachi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: herdr
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/herdr
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill herdr-traymachi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When running as an agent inside herdr, a terminal-native agent multiplexer, you need a way to see sibling panes, run commands in parallel terminals, and coordinate with other agents without leaving your own pane. This Skill provides the CLI commands to manage workspaces, tabs, and panes, read other panes' output, and wait for specific states. ## Core Features & Use Cases - Pane and Tab Management: List, create, split, rename, focus, and close workspaces, tabs, and panes using compact session ids. - Output Reading and Waiting: Read another pane's visible or recent scrollback text, and block until specific output text or an agent status (idle, working, blocked, done) appears. - Agent Coordination: Spawn new agent instances, send text or keystrokes to panes, and wait for sibling agents to finish before continuing. - Use Case: Split your pane, run npm run dev in the new pane, wait for the "ready on port 3000" output, then read the server log — all orchestrated from your own agent pane. ## Quick Start Check that HERDR_ENV is set to 1, then run herdr pane list to discover your pane and its neighbors.

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 the command line?▼

Use the herdr CLI binary, which talks to the running herdr instance over a local unix socket. Commands like herdr pane list, pane split, pane run, and pane read let you inspect and control panes, while workspace and tab subcommands manage higher-level contexts.

How to wait for specific terminal output in a herdr pane?▼

Use herdr wait output with a pane id, a --match string, and a --timeout in milliseconds. Add --regex for pattern matching; matching uses unwrapped recent terminal text, and the command exits with code 1 on timeout.

Can I use the herdr skill outside a herdr session?▼

No. The skill requires the HERDR_ENV environment variable to be set to 1, which only happens inside a herdr-managed pane. If it is not set, the skill instructs the agent to stop rather than inspect or control panes from outside.

How do I spawn and coordinate multiple AI agents in herdr?▼

Split a pane with herdr pane split, run an agent like claude in the new pane with pane run, then use herdr wait agent-status to block until that agent reaches a status such as done before reading its output with pane read.

Why did my herdr pane id stop working?▼

Pane, tab, and workspace ids are compact session ids that shift when panes, tabs, or workspaces are closed. Re-read current ids from pane list, tab list, or workspace list instead of reusing older ids.

Related Skills

Explore More Software Engineering Skills→
mei28mei28
3

herdr

Control herdr workspaces, tabs, and panes via a local unix socket.

Community
Intermediate
tomzxtomzx
5

audit-sdlc

Aggregate and rank audit findings from multiple SDLC checks into a report.

Community
Intermediate
humblemuzzuhumblemuzzu
5

tmux

Manage tmux windows to coordinate concurrent background tasks.

Community
Intermediate
furedeafuredea
1

herdr

Manage herdr terminal multiplexer workspaces, tabs, and panes via CLI commands.

Community
Intermediate