herdr

Manage herdr workspaces, tabs, panes, and sibling-agent coordination via CLI.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/ian-pascoe/dotfiles-chezmoi --skill herdr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: herdr
Source: https://github.com/ian-pascoe/dotfiles-chezmoi/tree/main/dot_agents/skills/herdr
Command: npx skills add https://github.com/ian-pascoe/dotfiles-chezmoi --skill herdr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill lets you manage a live herdr session from inside the terminal pane you are already using, so you can coordinate work without switching tools or losing context.

Core Features & Use Cases

  • Workspace control: List, create, focus, rename, and close workspaces to organize work by project or task.
  • Tab and pane orchestration: Create tabs, split panes, run commands, and keep related shells, agents, servers, and logs side by side.
  • Live coordination: Read output from other panes, wait for expected text or agent state changes, and follow progress across sibling agents.
  • Use case: Start a server in one pane, wait until it reports readiness, then inspect its logs or run tests in another pane without leaving the session.

Quick Start

Use this Skill when you are inside a herdr-managed pane to inspect the current session, coordinate nearby panes, and keep your work moving without leaving the terminal.

Frequently Asked Questions about herdr

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

FAQPage Schema
How do I control a live terminal multiplexer session without leaving my current pane?

You can control a live terminal multiplexer session by using a CLI that communicates with the running instance over a local unix socket, enabling workspace management, pane splitting, and output inspection directly from your current terminal.

How do I wait for a server to be ready before running tests in another terminal pane?

To wait for server readiness before running tests, you can monitor output from other panes and wait for expected text or agent state changes, allowing you to start a server in one pane and trigger tests in another once ready.

How do I split panes and create tabs to orchestrate terminal workspaces from the command line?

You can split panes and create tabs by using terminal workspace control commands to organize work by project, run commands side by side, and keep related shells, agents, servers, and logs visible within the same session.

Do I need any specific environment variables set to manage terminal workspaces from my pane?

Yes, you need the environment variable HERDR_ENV set to 1, and the herdr CLI must be available to communicate with the running instance over the local unix socket for pane orchestration to function correctly.

Can I read output from sibling agents running in different terminal panes?

Yes, you can read output from other panes and follow progress across sibling agents, enabling live coordination by inspecting logs and waiting for expected text or state changes without leaving your local terminal environment.

What is the best way to coordinate multiple terminal panes for local development workflows?

The best way to coordinate multiple terminal panes is using a session control CLI that manages workspaces, splits panes, and inspects live output, keeping related shells and servers side by side without switching tools or losing context.