# herdr-orchestration

herdr-orchestration controls interactive Claude and Codex worker TUIs in dedicated herdr tabs using socket CLI commands.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 210 installs · ★ 655 repo stars
- Author: Pedro Nauck
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/herdr-orchestration/SKILL.md
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — warning: suggests running the agent with permission prompts turned off. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/skills/herdr-orchestration

## What it does

The skill structures a controller agent to partition work across sub-agents. Each worker receives an isolated tab labeled with model and task slug. The primary agent keeps track of state via `HERDR_WORKSPACE_ID`, `HERDR_TAB_ID`, and `HERDR_PANE_ID`.

Workers require interactive TUI sessions rather than headless streams. Claude boots with `--dangerously-skip-permissions` while Codex takes `--yolo`, preventing stalls on confirmation dialogs. A running herdr daemon is mandatory; without it the socket CLI cannot detect agent readiness.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill herdr-orchestration -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/herdr-orchestration/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/herdr-orchestration/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill herdr-orchestration -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/herdr-orchestration/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill herdr-orchestration -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/herdr-orchestration/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedronauck/skills skills/mine/herdr-orchestration
```

2. **Manually: put the files in place**
- File: `.github/skills/herdr-orchestration/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill herdr-orchestration -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pedronauck/skills --path skills/mine/herdr-orchestration
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/herdr-orchestration/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill herdr-orchestration -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/herdr-orchestration/SKILL.md

## When to use it
- dispatch slices of work across autonomous Claude and Codex workers
- manage labeled herdr tabs without stealing terminal focus
- submit followup prompts atomically with status wait locks
- prevent stalled runs caused by headless JSON streams

## Example prompts
- Launch a Codex worker tab to review authentication routes
- Send a followup prompt to the refactoring worker and wait for completion

## Similar
- [herdr-core](https://affpapa.org/en/nevibecode/skills/herdr-core.md) — skill · 827 installs
- [openrig-herdr](https://affpapa.org/en/nevibecode/skills/openrig-herdr.md) — skill · ★ 8928 repo stars
- [herdr-fleet](https://affpapa.org/en/nevibecode/skills/herdr-fleet.md) — skill · ★ 62 repo stars
- [herdr-codex-subagents](https://affpapa.org/en/nevibecode/plugins/herdr-codex-subagents.md) — plugin · ★ 1596 repo stars
- [orchestration](https://affpapa.org/en/nevibecode/skills/orchestration.md) — skill · 359600 installs
- [cargo-orchestration](https://affpapa.org/en/nevibecode/skills/cargo-orchestration.md) — skill · 11600 installs

From the same set: [pedronauck/skills](https://affpapa.org/en/nevibecode/by/pedronauck/skills.md) — 52 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
