clawd-conduit
Plugin / AgentWire 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
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
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.
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.
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)
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/coordinatorCharted
Wire all 15 Claude Code hook events into the Clawd on Desk desktop pet — and turn permission requests into a blocking desktop card.
An unofficial Rust 1:1 reimplementation of the Claude Code terminal UI, ported file-for-file onto an iocraft TUI framework.
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.