herdr

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

Updated May 18, 2026
One-click install
npx skills add https://github.com/blalor/pi-dot-dev --skill herdr-blalor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: herdr
Source: https://github.com/blalor/pi-dot-dev/tree/main/agent/skills/herdr
Command: npx skills add https://github.com/blalor/pi-dot-dev --skill herdr-blalor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Herdr terminal sessions from an AI agent is error-prone when the agent relies on memorized or copied command syntax that may not match the installed Herdr version. This Skill ensures the agent always loads the live, version-accurate Herdr guidance and correctly identifies the calling pane before issuing control commands. ## Core Features & Use Cases - Live guidance loading: Runs herdr --skill at execution time so command syntax always matches the installed Herdr binary instead of a stale copied reference. - Reliable caller identification: Uses herdr pane current --current to resolve the actual Pi pane making the call, avoiding mistakes caused by UI focus belonging to another session. - Correct process launching: Prefers Herdr operations that supply a command as a pane's initial process rather than racing a second command against shell startup. - Use Case: While working in a Herdr-managed session, ask the agent to open a new tab running a test suite; the agent loads the live Herdr guide, identifies its own pane, and spawns the tab with the command as the initial process. ## Quick Start Ask the agent to use Herdr to open a new pane running your test command in the current workspace.

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 tabs from an AI agent?▼

Run herdr --skill first to load the installed version's command guidance, then follow it for all control operations. Inspect the relevant command's current help output before issuing any control command to confirm supported syntax.

How do I identify the current Herdr pane from a script or agent?▼

Use herdr pane current --current to resolve the pane actually making the call. Bare herdr pane current may return the pane focused in the Herdr UI, which can belong to another session after the user changes focus.

Can I rely on HERDR_ENV environment variables to detect Herdr sessions?▼

No, HERDR_ENV is unreliable as a guard because tool subprocesses may omit all HERDR_* variables even while running inside a Herdr-managed pane. Query the Herdr CLI directly to identify the calling pane instead.

What is the correct way to launch a command in a new Herdr pane?▼

Prefer the Herdr operation that supplies the command as the pane's initial process rather than creating an idle shell and racing a second command against shell startup. Confirm the supported syntax from the installed CLI before creating the pane.

What are the requirements for using the Herdr CLI with an agent?▼

The herdr CLI must be installed and a running Herdr session must be accessible. The agent loads guidance dynamically at execution time, so the instructions always match the installed Herdr version.