Item detail
github.com

shepherd-agents/shepherd

shepherd-agents/shepherd is a programmable meta-agent runtime in RepoRadar's Agent Runtime / Meta-Agent Substrate section, holding Gold tier and a 'try now' verdict. Its strongest signal is workflow potential, scored 10.0 out of 10.

Score8.5
Popularity1.0
Risklow
TierGold
Score breakdown
Usefulness8.0
Novelty9.0
Momentum8.0
Maturity6.6
Open-source/build8.4
Evidence7.2
Workflow potential10.0
Setup ease6.4

Popularity is tracked separately. Support, ads, sponsorships, and tips never affect these signals.

Why it matters

Useful for AI-curious readers, AI researchers, agent developers, AI infrastructure teams, meta-agent researchers, AI safety researchers, SRE / DevOps engineers, and engineering teams who want a runtime substrate for agent work that needs inspection, reversibility, and supervision -- and who can pair Shepherd with a Claude Code subscription or ANTHROPIC_API_KEY to drive the runtime (or use the Offl

Who should use it

AI-curious readers, AI researchers, agent developers, AI infrastructure teams, meta-agent researchers, AI safety researchers, SRE / DevOps engineers, and engineering teams who want a runtime substrate for agent work that needs inspection, reversibility, and supervision -- and who can pair Shepherd with a Claude Code subscription or ANTHROPIC_API_KEY to drive the runtime (or use the Offline Quickstart for keyless evaluation)Engineering teams that need an agent runtime with a signature-based Permissions model -- the task signature IS the permission surface, so the grant on a GitRepo is what lets the agent write the repository, and the user reviews the proposal before the change lands; this is the layer most agent frameworks leave to the consumer to reimplement as a wrapperAgent researchers who want a substrate with research-paper backing (arXiv 2605.10913) and a Git-like VCS core for the agent execution trace -- the copy-on-write fork is faster than docker commit and reuses ~95% of the KV cache on replay, so the replay path is cheap enough to use as a routine supervision surfaceMeta-agent builders who want a substrate that can observe, fork, replay, and revert agent runs -- the reversible execution-trace model is the layer that lets a meta-agent learn from, supervise, and re-train other agents

Who should skip it

Skip shepherd-agents/shepherd if the source link, documentation, or setup requirements do not align with your current workflow or stack.

About this signal

shepherd-agents/shepherd is tracked by RepoRadar as a programmable meta-agent runtime in the Agent Runtime / Meta-Agent Substrate section. It was first seen on 2026-07-06 and last updated on 2026-07-06. The current verdict is 'try now' with a Gold tier and moderate setup difficulty. The standout signals for shepherd-agents/shepherd are workflow potential (10.0) and novelty (9.0), while setup ease (6.4) trails — that balance shapes where it fits best. This page summarizes the evidence RepoRadar has captured from captured source metadata. The score, tier, risk label, and verdict on this page are never influenced by sponsorship, ads, or tips — they reflect only the usefulness, popularity, novelty, momentum, maturity, and evidence signals described in the RepoRadar methodology.

How this item is evaluated

RepoRadar assigned shepherd-agents/shepherd a composite score of 8.5 out of 10, placing it in the Gold tier. This score combines weighted sub-signals: usefulness (35%), novelty (18%), momentum (14%), maturity (10%), open-source/build quality (7%), evidence quality (6%), workflow potential (6%), and setup ease (4%). Popularity is tracked separately at 1.0 and never affects the composite score or tier. The risk label of 'low' reflects inherent user-impacting hazards, not generic novelty. Items with no risk flag may still require normal code review before production use.

Putting this into practice? Read How to vet an AI agent or MCP server before you wire it in for the checklist behind this score.

Risk explanation

Alpha stage with APIs that may still change between releases -- pin the API in pyproject.toml + review the CHANGELOG + the alpha -> stable release roadmap before upgrading; the runtime is new (12 days between created_at 2026-06-24 and this cycle 2026-07-06) and the community is small (667★) -- treat the first evaluation cycle as a smoke test (pip install + shepherd init + shepherd doctor claude + shepherd demo write + python <task>.py) before granting a real GitRepo write permission; the GitRepo write privilege is the headline attack surface in the Permissions model -- audit the task signature and the user-supplied prompt before granting it; and prefer the read-only sp.May[sp.GitRepo.

Evidence links
Closest alternatives / related signals
open-sourcemitagent-runtimemeta-agentsubstratereversible-executionexecution-tracegit-like-trace