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
Hızlı değerlendirme
Özet
Shepherd, agent çalışmalarını izlenebilir ve geri alınabilir çalıştırma izlerine dönüştürerek çıktıları inceleme, seçme veya reddetme olanağı sunan bir runtime altyapısıdır.
Profiline uyum
Agent çalıştırmalarını sandbox içinde inceleme, karşılaştırma ve insan onayıyla uygulama özellikleri, kullandığın agent mimarilerini denetleme ihtiyacına uyuyor.
Neden yükseliyor
95 günde 2465 yıldız, agent çalıştırmalarını denetleme ve geri alma fikrine belirgin ilgi olduğunu gösteriyor; ancak ilginin kaynağı verilmemiş ve son 28 gündeki 1 commit ile 1 farklı yazar, güncel geliştirme temposunun sınırlı olduğuna işaret ediyor.
Problem
Agent'ların yaptığı değişiklikleri denetlemek, başarısız çalışmaları yeniden oynatmak ve sonuçları doğrudan çalışma alanına uygulamadan önce gözden geçirmek zordur.
Çözüm
Python görevlerini sandbox içinde çalıştırır; çalışma izlerini ve üretilen dosyaları saklayarak sonuçların incelenmesini, seçilmesini, uygulanmasını veya atılmasını sağlar. README ayrıca copy-on-write fork ve replay sırasında KV-cache reuse özelliklerinden söz ediyor.
Yenilik
Agent çıktısını yalnızca loglamak yerine incelenebilir ve seçilebilir bir çalışma sonucu olarak ele alması, geri alma ve denetimi tek iş akışında birleştiren ayırt edici bir yaklaşım. README'deki yaklaşık 5x hız ve %95 KV-cache reuse değerleri proje iddiası; bu veriler burada bağımsız olarak doğrulanamıyor.
Teknolojiler
- Python 3.11+
- Claude CLI
- Anthropic API
- macOS Seatbelt
- Linux Landlock
- copy-on-write
Riskler
- Proje erken alpha aşamasında; API'lerin sürümler arasında değişebileceği belirtiliyor.
- Windows desteklenmiyor; macOS ve Linux için de sandbox uygulaması farklı işletim sistemi mekanizmalarına dayanıyor.
- Agent'ların kimlik bilgileri ve harici servislerle etkileşimi için kurulum ve sandbox sınırları dikkatle değerlendirilmelidir.
- Son 28 günde 1 commit ve 1 farklı yazar görülmesi, mevcut geliştirme sürekliliği hakkında sınırlı kanıt sunuyor.
- Hız ve KV-cache reuse ölçümlerinin hangi koşullarda elde edildiği, verilen bilgilerden anlaşılamıyor.
Detaylı değerlendirme
Bu repo için detaylı değerlendirme henüz yapılmadı. Analiz, Ayarlar'daki uyum profilini hesaba katarak "bu işime yarar mı" sorusunu cevaplıyor. Bir kez çalışır; günlük koşular buna dokunmaz. Saatlik sınır var — bir kaynaktan en fazla 3 analiz.