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.