pi-cowboy is a Herdr-native orchestrator that breaks large coding jobs into focused subtasks and runs them as parallel background agents using Pi or alternative harnesses like Codex, Claude Code, and OpenCode. Each agent runs in its own Herdr terminal pane and works in an isolated copy-on-write Git worktree, committing changes to a dedicated branch so you can watch progress, jump into any agent to steer it, review reports when it settles, and merge individual branches into your main tree. The tool auto-detects available harnesses on PATH, supports reusable agent templates for recurring roles, and provides orchestrator templates to enforce cross-agent rules and reporting cues.
Operation is centered on spawn → isolate → settle → merge → cleanup. Agents queue when concurrency limits are reached (default global limit 4) and occupy slots at multiple levels (global, per-harness, per-provider, per-model). Cleanup is safe by default: it won’t remove running agents, won’t delete worktrees with uncommitted changes, and only deletes branches after merge; a forced removal exists in the UI with explicit confirmation. Requirements include Linux or macOS, herdr >=0.8 with Pi integration, python3 for macOS, and a copy-on-write filesystem (APFS, BTRFS, ZFS) to keep disk overhead small - e.g., a 153k-file repo showed 75 MiB for pi-cowboy’s COW worktrees versus 479 MiB for classic worktrees and 27 GiB when including untracked files. Installation is via npm (pi install npm:pi-cowboy).
Summary generated by AI from the linked article. hn.today is not affiliated with Hacker News or Y Combinator.