Shepherd
Interactive mission control for fleets of Claude Code agents.
Shepherd runs sessions, drains backlogs into pull requests, and keeps a human in the loop where it matters — a single mission control for fleets of Claude Code agents.
Start here
Section titled “Start here”- Getting started — install Shepherd and sign in.
- Operating Shepherd — run it as a service, expose it over Tailscale, and deploy code changes.
- Authoring an epic — structure a GitHub epic Shepherd recognizes: native sub-issues, the epic-dag fence, and dependency edges.
- Hands-off epics — the automation settings that let an epic drain end-to-end, and what still stops it.
- Configuration — every environment variable.
- Concepts & glossary — the terms Shepherd uses.
- Plugins — extend Shepherd with server-side spawn hooks, routes, and UI.
- External Task API — queue work over HTTP.
- Security — the sandbox membrane and egress firewall.
Acknowledgements
Section titled “Acknowledgements”Shepherd is built on herdr, the agent multiplexer by Can Celik — it owns the real interactive PTYs that every Shepherd session runs in, and without it this whole project wouldn’t be possible. Thank you, Can.