ClaudeMap

Coordinator

A pair of Claude Code skills that turn one session into a manager: it briefs tasks, starts delegate sessions in their own worktrees and Herdr tabs, watches them, and cleans up when work lands

Plugins & Agentsorchestrationmulti-agentworktreeherdrpython

Coordinator is a higher-level agentic workflow for Claude Code, driven by Python scripts that run the Herdr terminal app. You start one coordinator session with /coordinator <domain>; it owns a domain (a repo or product area) and keeps its state in a Markdown backlog file — what the domain covers, what you approved for good, what is open, what is done — which is what survives a restart. Each incoming request becomes a brief, and the coordinator starts a separate delegate session for it in its own Git worktree and Herdr tab; each delegate writes a REPORT.md when it stops. A background watcher (fleet_watch.py) wakes the coordinator when a delegate finishes, asks something or gets stuck, and also on pull-request merges, check failures and reviews. A cap check keeps at most three delegates working at once and can hold open pull requests per repo under a limit you set; quiet delegates are ended after a day and resumed with the same session later. fleet-sweep, the second skill, removes finished worktrees, branches, tabs and stray processes but refuses anything that would lose work. The coordinator decides small reversible things itself and says what it chose, and batches its questions to you at most five at a time, each with options and a recommendation. Requirements: herdr-core, the Herdr app, Claude Code, Python 3.9+ (standard library only), git, and gh signed in; optional Codex delegates take small mechanical tasks, and the petekp/inbox mod collects questions in one pane. Tested on macOS against herdr-core 0.1.21, Herdr 0.1.15, Claude Code 2.1.325 and Codex 0.164.0.

What it does

  • One coordinator per domain: /coordinator <domain> keeps a Markdown backlog (scope, approvals, open, done) that survives restarts, and delegates get per-task briefs stating what done looks like and where to stop
  • Fleet mechanics: delegates run in their own Git worktrees and Herdr tabs, write REPORT.md on stop, and fleet_watch.py wakes the coordinator on finish, question, stuck state, PR merge, failed checks or review
  • Guardrails: a cap check holds at most three delegates at once and can enforce per-repo open-PR limits; quiet delegates are ended after a day and resumed with the same session; fleet-sweep refuses anything that would lose work
  • Escalation discipline: small reversible decisions are made and reported; questions to you arrive in batches of at most five with options and a recommendation
  • Script surface: delegate_start/cap/end, fleet_watch/status, backlog_check, coordinator_restart, watcher_check and sweep.py, each with --help; Python 3.9+ standard library only

When to use it

Use when one long-lived session should own a repo or product area and fan work out to parallel delegate sessions you can watch in one app — multi-task streams, long chores, staged refactors. Skip it if you do not want the Herdr app in the loop: delegates open as Herdr tabs, so the app is required.

Getting started

Let an agent set it up by pasting this into Claude Code:

Set up the coordinator workflow by following https://raw.githubusercontent.com/petekp/coordinator/main/SETUP.md

Or install by hand:

git clone https://github.com/petekp/coordinator.git ~/src/coordinator
~/src/coordinator/install.sh

install.sh links both skills into ~/.claude/skills and ~/.agents/skills, then checks for the tools above; keep the clone in place because the links point into it. Update with git pull (the watcher checks daily and never pulls by itself). Uninstall: ~/src/coordinator/install.sh --remove, then delete the clone.

herdr-core: curl -fsSL https://releases.herdr.dev/core/install.sh | sh  (Herdr app from herdr.dev)

Things to know

Delegates run in your Claude Code permission mode: in the default mode each stops at permission prompts and at the folder-trust prompt of each new worktree until answered in its tab. Removing a worktree parks its ignored files (such as .env and .scratch/) into <main checkout>/.scratch/parked/ — nothing deletes parked folders automatically. Codex delegates only start in repos you marked trusted in Codex, and Codex cannot replace Claude Code as the coordinator. Non-POSIX login shells (fish) route delegates through /bin/sh, which needs hc, claude and python3 on PATH. macOS-tested (herdr-core 0.1.21, Herdr 0.1.15, Claude Code 2.1.325, Codex 0.164.0). MIT. 47 stars as of writing (2026-11-21).

Repository

petekp/coordinator

Charted

Related on the map

  • clawd-conduit

    Plugin / Agent

    Wire all 15 Claude Code hook events into the Clawd on Desk desktop pet — and turn permission requests into a blocking desktop card.

    • hooks
    • desktop
    • notifications
    • claude-code
  • CometixCode

    Plugin / Agent

    An unofficial Rust 1:1 reimplementation of the Claude Code terminal UI, ported file-for-file onto an iocraft TUI framework.

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    Plugin / Agent

    Hook-level enforcement for the natural-language rules in AGENTS.md and CLAUDE.md — every edit is judged and violations are repaired in the same turn.

    • hooks
    • code-review
    • rules
    • agents-md