⚡
herdr-worker-orchestrator v0.5 Star
Deterministic Multi-Agent Runtime

Orchestrate AI Agents
with Absolute Reliability

Claude Code plans. Herdr supervises terminals. Isolated workers write code safely in Git worktrees with automated diff reviews.

Launch Live Simulator Watch 30s Video
LIVE DISPATCH SIMULATOR
Task:
Worker:
[ORCHESTRATOR LOG]
// Click DISPATCH to simulate.
> Claude orchestrator online (HERDR_ENV=1).
State Machine IDLE
1. pending — write briefing
2. working — pane split
3. verifying — diff review
4. passed — ledger commit

30-Second Walkthrough

See How It Works

Full 1080p motion graphics with English voiceover explaining the 3-layer architecture and safety heuristics.

3-Layer Runtime

Why 3-Layer Orchestration Wins

Separate planning, process supervision, and code generation into distinct execution zones.

🧠

Layer 1

Claude Code

Plans milestones, decomposes tasks, writes briefings. Never writes unverified code directly.

✓ .agents/BRIEFING.md
✓ Task State Machine
✓ Crash recovery
⚙️

Layer 2

Herdr Multiplexer

Controls terminal panes, lifecycle polling, and injects automation APIs to manage real TTY sessions.

✓ Live Pane Split
✓ Plugin Actions
✓ Real TTY interaction
🤖

Layer 3

Isolated Workers

Executes with agy, codex, or any CLI. Worktrees isolate files; a Reviewer inspects diffs.

✓ Git Worktree isolation
✓ Skip permissions mode
✓ Diff-based verification

Core Capabilities

5 Superpowers

Engineered to solve real failure modes discovered during deep empirical testing.

#1 — Git Worktree Isolation Zero Pollution

Workers operate in isolated git worktrees on dedicated branches. No file conflicts. True parallel multi-agent development.

// Isolated tree architecture
Project/
├── main worktree ← Claude works here
├── .worktrees/TASK-001 ← Worker 1 (agy)
└── .worktrees/TASK-002 ← Worker 2 (codex)
#2 — Stateful Task Ledger

Every task lives in .agents/tasks/TASK-xxx.json with lifecycle state transitions. If Claude restarts, resume picks up with zero loss.

✓ Survives session compactions
#3 — Diff-Enforced Review

The reviewer subagent is forbidden from reading worker self-reports. It only inspects git diff, runs tests, and verifies assertions.

✓ Evidence before assertions
#4 & #5 — Smart Heuristics

stalled ≠ failed. Our script inspects terminal transcripts for delivery markers before deciding to wait vs retry. Auto-injection of --dangerously-skip-permissions prevents interactive hangs.

Old Way
stalled → abort → user frustrated
Our Way
stalled → read transcript → found marker → pass!

Comparison

Single Agent vs Orchestrator

Capability Single Agent Herdr Orchestrator
Isolation ❌ Runs in active directory ✅ Git worktrees
Crash Recovery ❌ Lost on restart ✅ Stateful ledger
Verification ❌ Trusts self-report ✅ Diff review + tests
Delivery ❌ Silent drops ✅ Marker check
Cost ❌ Burns flagship quota ✅ Worker CLI quota

Quick Start

Install in 1 Click

Works as a Claude Code Plugin or natively in Herdr.

/plugin marketplace add https://github.com/anhnd3005-infinity/herdr-worker-orchestrator.git
/plugin install herdr-worker-orchestrator@herdr-worker-orchestrator-marketplace

Example Prompt

> "Use agy as a worker to create a RESTful API using FastAPI, test it thoroughly, and report the results."

ĐA

Đức Anh

AI Architect @ Infinity Tech

"Don't just prompt AI. Build deterministic runtime harnesses around them."

GitHub ⭐ Star on GitHub