herdr

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

3|Updated Jul 4, 2020
One-click install
npx skills add https://github.com/mei28/dotfiles --skill herdr-mei28
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: herdr
Source: https://github.com/mei28/dotfiles/tree/main/.claude/skills/herdr
Command: npx skills add https://github.com/mei28/dotfiles --skill herdr-mei28

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable programmatic control of a running herdr instance from inside a managed pane, allowing seamless orchestration of workspaces, tabs, and panes. It enforces the HERDR_ENV=1 precondition to ensure safe, pane-local control.

Core Features & Use Cases

  • Workspace, tab, and pane orchestration: create, focus, rename, and close workspaces, tabs, and panes from the CLI.
  • Agent lifecycle management: spawn agents, monitor running processes, and read outputs across panes.
  • State synchronization: wait for specific outputs or agent states to coordinate multi-pane tasks via the local unix socket.

Quick Start

Run a simple command to connect to the running herdr instance and list current workspaces.

Frequently Asked Questions about herdr

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

FAQPage Schema
How do I automate workspace and pane management from the CLI?

You can automate workspace and pane management by using a CLI to control a running instance, allowing you to create, focus, rename, and close workspaces, tabs, and panes programmatically over a local unix socket.

What is the best way to orchestrate agent lifecycles across multiple panes?

Orchestrating agent lifecycles involves spawning agents, monitoring running processes, and reading outputs across panes via local unix socket communication to coordinate multi-pane tasks effectively.

How does state synchronization work for multi-pane tasks via a unix socket?

State synchronization works by waiting for specific outputs or agent states over a local unix socket, allowing you to coordinate and synchronize complex multi-pane tasks programmatically.

Do I need a specific environment variable set to control a running instance safely?

Yes, you need the HERDR_ENV=1 environment variable set as a precondition to ensure safe, pane-local control before attempting any programmatic actions over the local unix socket.

Can I use CLI commands to focus or close specific tabs in a managed workspace?

Yes, you can use CLI commands to focus, rename, or close specific tabs in a managed workspace, enabling seamless programmatic orchestration of workspace layouts from inside a managed pane.

Why does my CLI automation fail to connect to the running instance?

CLI automation fails if the required binary is not in PATH, the local unix socket is unavailable, or the HERDR_ENV=1 precondition is not enforced before attempting actions.