shepherd-agents / shepherd
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
- Stars
- 2,633 stars
- Forks
- 227 forks
- Language
- Python
- License
- MIT
- Created
- Jun 24, 2026
- Last push
- Sep 9, 2026
- Updated
- Nov 12, 2026
Why these Tags: an agent read the README and quoted it
- Agent sandbox from the readme:
a write to a `ReadOnly`-granted repository, or to any managed path not covered by a `ReadWrite` grant, is refused at the syscall
- Agent framework from the readme:
Shepherd is an agent framework: a task's implementation can be a sandboxed agent, and its work comes back as a **reviewable proposal**
An agent gave these Tags from the fixed Tag list in the AwesomeRepos source code. A code check kept each Tag only when its quote is in the text. A wrong Tag? Report an error with the form at the end of this page.
Admitted to the Repository Index on Nov 11, 2026: +121 stars in 7 days.
Star History
138 days recorded, Jun 28, 2026 – Nov 12, 2026 (UTC). Net change +2,636 stars.
The star count of each day is the latest count minus the net stars of the later days.
Add this Star History to a README
The images follow the light or dark theme of the page that shows them, and update every hour.
Add ?theme=light or ?theme=dark
to the chart address to keep one theme.
Star History chart
[](https://awesomerepos.com/shepherd-agents/shepherd) Badge
[](https://awesomerepos.com/shepherd-agents/shepherd) Timeline
It gained stars on 119 of the 138 days recorded since Jun 28, 2026.
Its largest 7 days were Jul 5, 2026 to Jul 11, 2026: 1,307 stars.
In the 30 days to Nov 12, 2026 it got 159 stars, 101% more than in the 30 days before.
- Created on the Repository Host
- Release v0.1.3
- Reached 500 stars, 11 days after it was created
- Largest star day recorded: +526 stars, the same day as release v0.2.0
- Release v0.2.0
- +382 stars in one day
- Release v0.2.1
- Reached 1,000 stars, 13 days after it was created
- Release v0.3.0
- +255 stars in one day
- Release v0.3.1
- Latest push
- Entered the Repository Index: +121 stars in 7 days
The timeline comes from the creation date and the releases on the Repository Host, the Admission, the Star History, and the Observations. Star milestones show only when the Star History records the day. The list shows up to 5 stable releases from the latest 10 releases recorded. When none of them is stable, one item counts the pre-releases. On the chart of net stars each day, a solid line marks each recorded release.
Forks and pushes
From 2 Observations, Nov 12, 2026 – Nov 13, 2026. Forks 0. AwesomeRepos saw a new push on 0 of 1 days.
- Nov 13, 2026: no new push
A filled day: the last push time changed since the Observation before it.
Health facts
Measured facts in four separate dimensions, each with a date and a source. AwesomeRepos does not add them into one score. AwesomeRepos last read these facts from GitHub on Nov 13, 2026. How AwesomeRepos defines each check
Copies a prompt for a coding agent. It has 1 task for the maintainers of shepherd-agents/shepherd.
Improve the Health Facts of the GitHub repository shepherd-agents/shepherd. AwesomeRepos measures facts about how a repository is maintained, released, secured, and documented. Its page for this repository is https://awesomerepos.com/shepherd-agents/shepherd. A change to the repository can improve each of the item below. Each item gives the measured fact or score, and a task. 1. A changelog file at the root Fact: No changelog file at the root (GitHub, 2026-11-13). Rule: The root of the default branch has a file named CHANGELOG, CHANGES, HISTORY, NEWS, RELEASE, or RELEASES, with no extension or with .md, .markdown, .rst, .txt, or .adoc. Release notes on GitHub releases do not count. Task: Add CHANGELOG.md at the root of the default branch. Write one section for each published release, newest first, from the GitHub releases, the Git tags, and the commit history. Do not invent changes. If the project uses a release tool (for example Changesets, release-please, or semantic-release), configure it to update this file for each release. Rules for this work: - Each file must be true for this project. Do not copy text that does not apply to it. - Do not choose a licence, a contact, or a release version for me. Ask me. - Do not publish a release, change a repository setting, or push to the default branch. Make the changes on a new branch. - Keep each change small, and run the checks of this repository before you finish. - At the end, list each item as DONE, SKIPPED (with the reason), or NEEDS A DECISION (with the question). AwesomeRepos reads these facts again in its next scan. The definitions of the checks: https://awesomerepos.com/health-facts
Maintenance
3 of 4 checks-
Yes: Not archived
GitHub does not mark the repository as archived. Source
-
Yes: A push in the last 90 days
Last push on 2026-09-09, 64 days ago. Source
-
Yes: Commits in the last 13 weeks
1 commit on the default branch in the last 13 weeks (GitHub, 2026-11-13). Source
-
No: Commits in 26 or more of the last 52 weeks
Commits in 6 of the last 52 weeks (GitHub, 2026-11-13). Source
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 1
- 28
- 86
- 0
- 5
- 0
- 0
- 5
- 0
- 0
- 0
- 1
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
- 0
Releases
2 of 3 checks-
Yes: A release in the last 365 days
Newest release v0.3.1 on 2026-09-09, 64 days ago. 5 releases in the last 365 days. Source
-
Yes: The newest release tag is a semantic version
The newest release tag is v0.3.1. Source
-
No: A changelog file at the root
No changelog file at the root (GitHub, 2026-11-13).
Security practice
1 of 1 check-
Yes: A security policy
GitHub finds a security policy (GitHub, 2026-11-13). Source
OpenSSF Scorecard has no result for this repository from the last 90 days.
Community files
3 of 3 checksObservations
Latest Observation, Nov 13, 2026: 2,633 stars, 227 forks, last push Sep 9, 2026, not archived. One of 2 Observations since Nov 12, 2026.