{"adoption": {"forks": 205, "observed_at": "2026-08-28T04:06:41.921366+00:00", "stars": 2376}, "canonical_url": "https://ross.abutalabs.com/products/shepherd-agents-shepherd", "card": {"archived": false, "artifact_type": "framework", "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", "domain": ["large-language-models", "developer-tools", "reinforcement-learning"], "enriched": true, "function": ["agent-framework", "workflow-automation", "mcp", "tracing", "llm-inference", "reinforcement-learning"], "health_score": 98, "homepage": "https://shepherd-agents.ai/", "language": "Python", "license": "MIT", "license_family": "permissive", "maturity": "experimental", "member_repos": ["shepherd-agents/shepherd"], "name": "shepherd-agents/shepherd", "platform": ["python", "cli"], "pushed_at": "2026-08-09T20:42:47+00:00", "repo": "shepherd-agents/shepherd", "stars": 2376, "tags": ["meta-agents", "execution-traces", "reversibility", "copy-on-write", "kv-cache-reuse", "agent-supervision", "tree-search-rl", "counterfactual-optimization", "permissions", "sandboxed-agents", "sandboxing", "replay", "ai-agents", "automation", "macos", "linux"], "topics": ["meta-agents", "meta-optimization", "runtime-supervision", "workflow-automation", "mcts-rl", "tree-rl"], "urls": [], "use_cases": ["supervise and intercept risky actions from parallel coding agents", "replay agent runs from a past state to test workflow edits", "fork agent execution to explore alternative trajectories", "train agents with tree-search reinforcement learning over execution traces", "run sandboxed agent tasks whose file changes arrive as reviewable proposals", "revert an agent's environment to any prior state quickly", "build meta-agents that coordinate, halt, or repair other agents"], "what_it_is": "Shepherd is a Python runtime substrate that records LLM agent executions as reversible, Git-like traces so meta-agents can inspect, fork, replay, and revert any run. It couples agents with copy-on-write forked environments and enforces OS-level permissions, enabling supervision, counterfactual optimization, and tree-search RL over other agents.", "when_to_avoid": ["you need Windows support (only macOS and Linux enforce grants; use WSL)", "you need a production-stable framework (it is early alpha with changing APIs)", "you just want a simple chatbot or agent loop without trace/replay machinery"], "when_to_choose": ["you need runtime observability and reversibility over LLM agent executions", "you are building meta-agents that manage, optimize, or train other agents", "you want sandboxed agent tasks with OS-enforced permission grants and reviewable changesets", "you need fast forking/replay of agent environments for counterfactual or RL experiments"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/shepherd-agents-shepherd", "repo": "shepherd-agents/shepherd", "role": "main", "score": 76}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T02:35:02.037852+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a181f2508327aef05264fe257f70fab568b66b3df399115aa51622cda944887c", "fetched_at": "2026-08-28T04:06:41.921366+00:00", "kind": "readme", "missing": false, "url": "https://github.com/shepherd-agents/shepherd"}, {"content_hash": "2e3baf2b134a470045ef31ebb2699f7cc69767a292174fa631d49b6000b26713", "fetched_at": "2026-08-29T10:16:01.820759+00:00", "kind": "homepage", "missing": false, "url": "https://shepherd-agents.ai/"}, {"content_hash": "3a2b1b8dbf31acef16129c0adcf1295cf84e1b70806436e20842a5c5298c06a4", "fetched_at": "2026-08-29T10:16:01.823345+00:00", "kind": "site_page", "missing": false, "url": "https://docs.shepherd-agents.ai/"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T02:35:02.037852+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a181f2508327aef05264fe257f70fab568b66b3df399115aa51622cda944887c", "fetched_at": "2026-08-28T04:06:41.921366+00:00", "kind": "readme", "missing": false, "url": "https://github.com/shepherd-agents/shepherd"}, {"content_hash": "2e3baf2b134a470045ef31ebb2699f7cc69767a292174fa631d49b6000b26713", "fetched_at": "2026-08-29T10:16:01.820759+00:00", "kind": "homepage", "missing": false, "url": "https://shepherd-agents.ai/"}, {"content_hash": "3a2b1b8dbf31acef16129c0adcf1295cf84e1b70806436e20842a5c5298c06a4", "fetched_at": "2026-08-29T10:16:01.823345+00:00", "kind": "site_page", "missing": false, "url": "https://docs.shepherd-agents.ai/"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T02:35:02.037852+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a181f2508327aef05264fe257f70fab568b66b3df399115aa51622cda944887c", "fetched_at": "2026-08-28T04:06:41.921366+00:00", "kind": "readme", "missing": false, "url": "https://github.com/shepherd-agents/shepherd"}, {"content_hash": "2e3baf2b134a470045ef31ebb2699f7cc69767a292174fa631d49b6000b26713", "fetched_at": "2026-08-29T10:16:01.820759+00:00", "kind": "homepage", "missing": false, "url": "https://shepherd-agents.ai/"}, {"content_hash": "3a2b1b8dbf31acef16129c0adcf1295cf84e1b70806436e20842a5c5298c06a4", "fetched_at": "2026-08-29T10:16:01.823345+00:00", "kind": "site_page", "missing": false, "url": "https://docs.shepherd-agents.ai/"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T02:35:02.037852+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a181f2508327aef05264fe257f70fab568b66b3df399115aa51622cda944887c", "fetched_at": "2026-08-28T04:06:41.921366+00:00", "kind": "readme", "missing": false, "url": "https://github.com/shepherd-agents/shepherd"}, {"content_hash": "2e3baf2b134a470045ef31ebb2699f7cc69767a292174fa631d49b6000b26713", "fetched_at": "2026-08-29T10:16:01.820759+00:00", "kind": "homepage", "missing": false, "url": "https://shepherd-agents.ai/"}, {"content_hash": "3a2b1b8dbf31acef16129c0adcf1295cf84e1b70806436e20842a5c5298c06a4", "fetched_at": "2026-08-29T10:16:01.823345+00:00", "kind": "site_page", "missing": false, "url": "https://docs.shepherd-agents.ai/"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T02:35:02.037852+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a181f2508327aef05264fe257f70fab568b66b3df399115aa51622cda944887c", "fetched_at": "2026-08-28T04:06:41.921366+00:00", "kind": "readme", "missing": false, "url": "https://github.com/shepherd-agents/shepherd"}, {"content_hash": "2e3baf2b134a470045ef31ebb2699f7cc69767a292174fa631d49b6000b26713", "fetched_at": "2026-08-29T10:16:01.820759+00:00", "kind": "homepage", "missing": false, "url": "https://shepherd-agents.ai/"}, {"content_hash": "3a2b1b8dbf31acef16129c0adcf1295cf84e1b70806436e20842a5c5298c06a4", "fetched_at": "2026-08-29T10:16:01.823345+00:00", "kind": "site_page", "missing": false, "url": "https://docs.shepherd-agents.ai/"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T02:35:02.037852+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a181f2508327aef05264fe257f70fab568b66b3df399115aa51622cda944887c", "fetched_at": "2026-08-28T04:06:41.921366+00:00", "kind": "readme", "missing": false, "url": "https://github.com/shepherd-agents/shepherd"}, {"content_hash": "2e3baf2b134a470045ef31ebb2699f7cc69767a292174fa631d49b6000b26713", "fetched_at": "2026-08-29T10:16:01.820759+00:00", "kind": "homepage", "missing": false, "url": "https://shepherd-agents.ai/"}, {"content_hash": "3a2b1b8dbf31acef16129c0adcf1295cf84e1b70806436e20842a5c5298c06a4", "fetched_at": "2026-08-29T10:16:01.823345+00:00", "kind": "site_page", "missing": false, "url": "https://docs.shepherd-agents.ai/"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:06:41.921366+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T02:35:02.037852+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a181f2508327aef05264fe257f70fab568b66b3df399115aa51622cda944887c", "fetched_at": "2026-08-28T04:06:41.921366+00:00", "kind": "readme", "missing": false, "url": "https://github.com/shepherd-agents/shepherd"}, {"content_hash": "2e3baf2b134a470045ef31ebb2699f7cc69767a292174fa631d49b6000b26713", "fetched_at": "2026-08-29T10:16:01.820759+00:00", "kind": "homepage", "missing": false, "url": "https://shepherd-agents.ai/"}, {"content_hash": "3a2b1b8dbf31acef16129c0adcf1295cf84e1b70806436e20842a5c5298c06a4", "fetched_at": "2026-08-29T10:16:01.823345+00:00", "kind": "site_page", "missing": false, "url": "https://docs.shepherd-agents.ai/"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T02:35:02.037852+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a181f2508327aef05264fe257f70fab568b66b3df399115aa51622cda944887c", "fetched_at": "2026-08-28T04:06:41.921366+00:00", "kind": "readme", "missing": false, "url": "https://github.com/shepherd-agents/shepherd"}, {"content_hash": "2e3baf2b134a470045ef31ebb2699f7cc69767a292174fa631d49b6000b26713", "fetched_at": "2026-08-29T10:16:01.820759+00:00", "kind": "homepage", "missing": false, "url": "https://shepherd-agents.ai/"}, {"content_hash": "3a2b1b8dbf31acef16129c0adcf1295cf84e1b70806436e20842a5c5298c06a4", "fetched_at": "2026-08-29T10:16:01.823345+00:00", "kind": "site_page", "missing": false, "url": "https://docs.shepherd-agents.ai/"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T02:35:02.037852+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a181f2508327aef05264fe257f70fab568b66b3df399115aa51622cda944887c", "fetched_at": "2026-08-28T04:06:41.921366+00:00", "kind": "readme", "missing": false, "url": "https://github.com/shepherd-agents/shepherd"}, {"content_hash": "2e3baf2b134a470045ef31ebb2699f7cc69767a292174fa631d49b6000b26713", "fetched_at": "2026-08-29T10:16:01.820759+00:00", "kind": "homepage", "missing": false, "url": "https://shepherd-agents.ai/"}, {"content_hash": "3a2b1b8dbf31acef16129c0adcf1295cf84e1b70806436e20842a5c5298c06a4", "fetched_at": "2026-08-29T10:16:01.823345+00:00", "kind": "site_page", "missing": false, "url": "https://docs.shepherd-agents.ai/"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T02:35:02.037852+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "a181f2508327aef05264fe257f70fab568b66b3df399115aa51622cda944887c", "fetched_at": "2026-08-28T04:06:41.921366+00:00", "kind": "readme", "missing": false, "url": "https://github.com/shepherd-agents/shepherd"}, {"content_hash": "2e3baf2b134a470045ef31ebb2699f7cc69767a292174fa631d49b6000b26713", "fetched_at": "2026-08-29T10:16:01.820759+00:00", "kind": "homepage", "missing": false, "url": "https://shepherd-agents.ai/"}, {"content_hash": "3a2b1b8dbf31acef16129c0adcf1295cf84e1b70806436e20842a5c5298c06a4", "fetched_at": "2026-08-29T10:16:01.823345+00:00", "kind": "site_page", "missing": false, "url": "https://docs.shepherd-agents.ai/"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 96, "longevity": 5, "rhythm": 92}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["young"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 70, "days_push": 24, "days_rel": 56, "gap_med": 1, "n_releases_24m": 4}, "score": 76, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}