sumHerdr-native agent distrodocsinstallgithub ↗

Many agents.
One finished task.

Dispatch approved work to isolated agents. A small Herdr-native distro: coordinator, workers, verification. It is for someone who already has mise, Git, and an authenticated coding harness. The default path is one finished task.

Coordinator
Whatever harness you launch here. Codex, Claude, Grok, cursor-agent, pi, OpenCode, Devin.
Process owner
Herdr owns processes and worktrees. No sum daemon, scheduler, or database server.
Records
A small synchronous helper, bin/sumctl, preserves task records.
01
A separate worktree per worker

The coordinator prepares a Herdr worktree, launches the selected worker, and returns control to you. A worker is explicitly given its own role; it does not become another coordinator.

02
Nine delivery gates

Recorded on the PR. Verification →

IntentRebaseReviewTestDocumentLintPushPRCI
03
Evidence on the PR

Before/after evidence publishes on pr reconcile unless you turn it off.

04
Seven bundled skills

/sum-dispatch, /sum-work, /sum-deliver, /sum-status, /sum-develop, /sum-factory, and /sum-update with rolling session refresh and code-only rollback.Skills →

05
Default-on Herdr delivery

Native event delivery starts with coordinator init; sidebar metadata remains opt-in. Herdr backend →

06
Portable verification

A project-root VERIFY.md and mise run verifywork in any clone without sum or Herdr.

Quick start
git clone https://github.com/douglasjarquin/sum.git
herdr
# In a Herdr pane:
cd /path/to/sum
mise trust
mise run setup
codex # or claude, grok, cursor-agent, pi, opencode, devin

A harness that does not auto-load AGENTS.md needs this first prompt:"Read AGENTS.md in this directory, initialize sum, and act as my coordinator."

How it works
you
approved requests and decisions ↓
coordinator
brief, Herdr worktree, launch ↓
worker
questions, report, PR ↑

A question is saved before notification. A successful send is submitted, not acknowledged. Native idle or done is not task completion, and a worker's report is not verified success.