{"repo":"shepherd-agents/shepherd","free":true,"listed":false,"github":"https://github.com/shepherd-agents/shepherd","clone":"git clone https://github.com/shepherd-agents/shepherd.git","description":"A runtime substrate that turns an agent's execution into a reversible, Git-like trace, so meta-agents can observe, fork, replay, and revert any run. Couples agent and environments in a copy-on-write fork ~5x faster than docker commit, with ~95% KV-cache reuse on replay. Framework built for meta-agents to supervise, optimize, and train other agents","language":"Python","stars":2317,"topics":["meta-agents","meta-optimization","runtime-supervision","workflow-automation","mcts-rl","tree-rl"],"license":"MIT","category":"workflow-automation","readme_excerpt":"Shepherd: Programmable Meta-Agents via Reversible Execution Traces --- [!IMPORTANT] Shepherd is in early alpha and under active development. APIs may still change between releases. Feedback and issues are very welcome! Install Quickstart Permissions Examples Docs Citation Shepherd is a runtime substrate for agent work that needs inspection, reversibility, and supervision. It records agent runs as durable, inspectable execution traces, with retained workspace outputs that can be reviewed before they are selected, applied, released, or discarded. Platforms. Shepherd requires Python 3.11+ . OS-level grant enforcement is executed on both macOS (Seatbelt) and Linux (Landlock, in a privileged container). Windows is unsupported (enforcement would be advisory-only at best) — use WSL . Installation Working on Shepherd itself? Install the local editable closure instead: python -m venv .venv && . .venv/bin/activate && pip install -r requirements-dev.txt (see CONTRIBUTING.md). Quickstart Shepherd is an agent framework: a task's implementation can be a sandboxed agent, and its work comes back as a reviewable proposal — nothing touches your files until you accept it. Here the whole body of a task is a Claude agent. Needs the claude CLI — signed in (a Claude subscription works) or with an ANTHROPIC API KEY . Neither? Jump to the Offline Quickstart — it runs anywhere, keyless. On a subscription, a sandboxed run is most reliable with a long-lived token: export CLAUDE CODE OAUTH TOKEN=$(claude","default_branch":null,"files":null,"tree":[],"storefront":"/r/shepherd-agents","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/shepherd-agents/shepherd/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}