herdr-projects → Shepherdr 深度调研

By 陈成 · Published October 29, 2026

herdr-projects 是什么,怎么演变成 Shepherdr,社区怎么看?

调研日期:2026-10-29 来源:X 书签(x.com/i/history 搜 "herdr")、各条推文的评论区、X 搜索 "herdr-projects" / shepherdr、GitHub 仓库与文档、herdr.dev 插件市场、Reddit(r/herdr 及全站搜索)

TL;DR


1. 背景:herdr 与 "Projects" 范式

2. 版本演进时间线

timeline
    title herdr-projects → Shepherdr
    2026-09-16 : herdr-agent-progress 插件<br/>agent 自报进度 %
    2026-09-18 : herdr-projects 发布<br/>对标 Claude Projects
    2026-09-24 : 48h 进插件前 15<br/>coordinator + 并行 thread + 侧栏进度
    2026-09-25 : /autoproject<br/>受 Karpathy autoresearch 启发的 ratchet loop
    2026-10-13 : 预告大改版<br/>远程机器跑通
    2026-10-16 : v1.0 从零重写<br/>任务看板 + 第二个 agent review<br/>旧版 Rust 0.2.35 进 legacy 分支
    2026-10-19 : 预告语音双工通话
    2026-10-21 : 自治 "软件工厂"<br/>每日 triage→build→review→merge
    2026-10-23 : Autopilot 内测
    2026-10-26 : "looks like gui wins after all"
    2026-10-29 : v2.0.0 改名 Shepherdr<br/>GUI WebApp,全插件化
版本 时间 形态 关键变化
0.1 – 0.2.35 9/18 – 10/15 Rust,跑在 herdr 侧栏 / popup coordinator 拆 thread,每个 thread 一个 worktree;侧栏显示进度 %;prefix+a 弹出所有 project;## Remember 写回项目记忆;/autoproject
1.0 – 1.2.27 10/16 – 10/28 TypeScript 重写,看板 TUI + herdr-web-ui(现名 Ovis)手机端 任务分 5 组(needs you / ready to approve / working / to do / done);Enter 建任务,Tab 建任务并立刻派 agent;完成后跑 check + 第二个 agent review;best-of-n、时间/token 上限、fallback agent、automations
2.0.0 Shepherdr 10/29 GUI Web App(Bun),走 Tailscale 私有访问,可加到手机主屏 space 各带 coordinator;Autopilot;卡片 + 推送;语音;分屏;内置浏览器;PR/diff 视图;artifacts;全插件化;不再依赖 Ovis

升级路径:herdr plugin update herdr-projects 会直接升到 Shepherdr,旧配置会备份;1.2.27 留在 legacy-herdr-projects 分支,TUI 留在 legacy 分支,作者说欢迎任何人接手(回复)。

3. Shepherdr v2 怎么工作

3.1 架构

flowchart LR
    subgraph Devices["你的设备(tailnet 内)"]
        Phone["📱 手机 / 平板"]
        Desk["🖥 桌面浏览器"]
    end

    subgraph Main["主机器(装 Shepherdr)"]
        App["Shepherdr App<br/>Bun 服务<br/>~/.shepherdr/"]
        Herdr["herdr daemon"]
        subgraph Space["Space = 某机器上的一个文件夹"]
            Coord["Coordinator agent<br/>(长期会话)"]
            T1["Task SHE-1<br/>agent @ worktree<br/>work/1-xxx"]
            T2["Task SHE-2<br/>agent @ worktree<br/>work/2-yyy"]
            Rev["Reviewer agent<br/>(fresh eyes)"]
        end
    end

    subgraph Remote["其他机器(herdr machine add)"]
        Helper["小 helper 目录"]
        RT["远程 Task agents"]
    end

    Phone & Desk -- "tailscale serve(不公开)" --> App
    App <--> Herdr
    Herdr --> Coord & T1 & T2 & Rev
    Coord -- "shepherdr task add" --> T1 & T2
    T1 & T2 -- "完成" --> Rev
    Rev -- "通过 → PR / 合并 main" --> GH[(GitHub / 本地 main)]
    Herdr -- "herdr remote / SSH" --> Helper --> RT
    App -. "Web Push 推送" .-> Phone
    App -. "语音(可选)" .-> EL[ElevenLabs]

要点(来自 README 和 docs/tasks.md):

3.2 任务生命周期

stateDiagram-v2
    [*] --> ToDo: coordinator 加任务(--later)
    [*] --> Queued: --after SHE-12
    [*] --> Working: 直接开工
    ToDo --> Working: 你说 go
    Queued --> Working: 依赖的任务全部完成
    Working --> NeedsYou: 提问 / 要权限 / 要批准 plan / 掉登录
    NeedsYou --> Working: 你在卡片里回复
    Working --> Review: agent 报告完成
    Review --> Working: 有 ≥ Must fix(默认 major)的问题<br/>最多 3 轮
    Review --> Ready: review 通过
    Ready --> Merging: 自动合并<br/>或你确认(ask me first)
    Merging --> Done: Merged / Nothing to merge
    Done --> [*]: 删除 worktree 和分支<br/>(有未提交内容则保留)

3.3 Autopilot 与 Automations

3.4 /autoproject(0.2 时代的 ratchet loop)

来自 9/25 的推文:给 coordinator 一份项目 brief、一份 reviewer rubric 和上限 → maker agent 每次只提交一个改动 → 全新的 reviewer agent 盲评(maker 看不到 rubric)→ 变好就合并为 PR,变差就丢掉 → 一直循环到触达上限,可以跑几十到几百轮。思路来自 Karpathy 的 autoresearch。

3.5 全插件化

places、chats、tasks、artifacts、terminal、browser、voice、alerts、Autopilot 全是插件。用户插件放在 ~/.shepherdr/plugins/<name>/,可以往顶栏、菜单、侧面板 tab、设置页、快捷键这些 slot 里加功能,或者同名覆盖内置插件的界面部分,主题用 CSS 变量改。保存后几秒内自动重建重启,坏掉的插件会被隔离,不影响其他部分。升级不会动这个目录,所以不用 fork 也能定制。作者认为这是 v2 最重要的功能("the killer feature imo"),评论区也有人特别点出这一点(@724real)。

3.6 安全与权限(README 写得很直白)

4. 安装

# 前置:macOS/Linux、herdr ≥ 0.9、Git、Tailscale、任一 agent CLI
# 可选:gh(PR)、Chrome(共享浏览器)、ElevenLabs key(语音)
herdr plugin install eliasstravik/shepherdr
# 在 herdr 里执行插件 action "Share Shepherdr on my tailnet" → 拿到链接
# 手机打开链接 → 加到主屏 → 设置里打开推送
shepherdr doctor   # 检查所有机器的状态

老用户:herdr plugin update herdr-projects。

5. 社区反馈(评论区汇总)

5.1 正面

观点 出处
coordinator-worker 结构在 Claude 里已经证明好用,herdr 也有了 @theandrewsiah
v1 比 0.2 清爽很多,之前 UX 太累 @dotslashnaz;作者回复:"我现在几乎不用进 agent 聊天,只看 mission control"
每个 worker 一个 worktree + 第二个 agent review,是并行时的安全网 @catmanyau、@724real
"一周内项目整体提速" @ianfs
第一次没看懂放弃了,再试时发现满足所有需求,只希望新建 project 的摩擦小一点 @ceciiiax
公司内部也有类似产品,coordinator 是"VP of Eng","只需和一个人说话"收益巨大 @brunodagnino
Claude Projects 还没到 Team/CLI,先用 herdr-projects 练手 @uehaj(日语)
AI shed 实践:Beelink 128G + Omarchy + Herdr + Collie + Herdr Projects,Tailscale 手机遥控 @dpaluy

5.2 质疑与痛点

问题 出处 作者回应 / 现状
review 绑定的 commit:worker 同步 main 后 diff 变了,旧的 review 不该默认算通过 @hexablob、@huymnguyen_ "let me see if i can figure out a nice fix"
别强制工作流,coordinator 只管协调就行 @ronos_r 可以让 coordinator 改流程,比如不要 reviewer
强制 worktree 不可接受 @michabbb 非 repo 不强制;v1 起可以默认开/关或单次关闭
token 效率?Firstmate 大约是普通流程的 2–3 倍 @CicekAyhan、@b1rkh0ff "worry less about tokens and more about your time";worker 可以换便宜模型或其他 harness
用 Linear + 需同事批准 PR 的团队,大量任务误报 "needs me" 卡住 @micneeley14 作者请对方私信录 loom 排查
很多机制不清楚,要读代码;在 coordinator 里指定模型会坏 @koslib 作者"用 herdr-projects 修 herdr-projects"
无人参与的自动合并"很勇" @yesadok 作者:"im scared to death honestly"
多个 worktree 同时跑 app,端口和数据库怎么隔离? @cagatay_dev 未见回复
一个 coordinator 处理多个不相关任务效率低,新开 project 又用不上记忆 @maxyou2090 "下个版本会更好";v2 的 space 模型就是对此的回应
更希望 herdr 保持纯粹的 multiplexer @lcorneliussen "nothing wrong with vanilla"
Windows(无 WSL)能用吗?reviewer 能换模型吗? @babykswanson、@hey_moamen 文档写明只支持 macOS/Linux;reviewer 可用 --reviewer / --reviewer-model 指定

GitHub 上当前开着的 issue(截至 10/29):#431 批准 plan 后马上发消息会导致 agent 无法写入;#432 怎么给单个 coordinator 配自己的 skills。最近关闭的有 "完成的任务约一小时后掉进 'Stopped without a summary'"(#423)、"GitHub checks 等一个在 PR head 上永远不会触发的 workflow"(#420)等,说明边界情况还多。

6. 竞品 / 相邻项目

quadrantChart
    title 多 agent 编排工具(定性,仅示意)
    x-axis "终端原生" --> "GUI / 移动端"
    y-axis "单会话调度" --> "项目级 mission control"
    quadrant-1 "GUI 版 mission control"
    quadrant-2 "TUI 版 mission control"
    quadrant-3 "终端内协作"
    quadrant-4 "移动遥控"
    "Shepherdr v2": [0.8, 0.9]
    "herdr-projects v1": [0.3, 0.8]
    "herdr-dagr": [0.25, 0.65]
    "Firstmate": [0.35, 0.7]
    "odysseus": [0.2, 0.6]
    "herdr agent skill": [0.15, 0.3]
    "Ovis": [0.75, 0.3]
    "herdrup": [0.85, 0.25]
    "Claude Projects": [0.9, 0.85]
项目 关系
Claude Projects(Anthropic) 灵感来源;云端运行,关机后照样跑。Shepherdr 跑在自己的机器上,机器关了就停
Firstmate(@kunchenguid) 评论里被比较最多的;作者没用过,认为两者是"替代品而非互补"
herdr-dagr 把 agent 群显示成实时 DAG,带 review gate;tonbi 的 YouTube 视频把它和 herdr-projects 一起评测
herdr-plugin-odysseus "Governed multi-agent workflows for Herdr"
Pi Herdsman、Cyrus r/herdr 和评论区提到的其他协调层
Ovis(原 herdr web ui) v1 的手机端依赖它;v2 不再依赖,改成自己的 GUI
Moshi / herdrup / Remotly / TermHub / pairfob 手机远程接入 herdr 的各种客户端,作者自己用 Moshi
claude duet、Claude agent view、Codex command center、Linear 作者自己的类比:"v1 is if claude agent view, codex command center and linear had a baby";v2 是 "claude duet, but made for developers"

7. 重名提醒:不止一个 "shepherdr"

仓库 是什么
eliasstravik/shepherdr 本文主角,即原 herdr-projects
theam/shepherdr The Agile Monkeys 做的原生 macOS 控制台,10/23 发布(推文)
luiscleto/shepherdr 适配手机的 herdr Web 界面,9 月就有
IgorWarzocha/howaboua-pi-stuff · pi-shepherdr @Howaboua 的 pi 扩展,有 agent 留言板、notes 历史

另外 r/herdr 上还有两个叫 "Shepherd" 的应用(Flutter 安卓端、macOS 原生窗口)。安装时请认准 herdr plugin install eliasstravik/shepherdr。

8. 我的判断

  1. 它代表一个方向:从 coding agent 到 coordinator agent。 用户只跟一个 coordinator 对话,执行交给一群"一次性"的 worker,加上隔离(worktree)、独立 review、状态自报、手机审批。Claude Projects 和 Codex 也在往这个方向走,Shepherdr 的不同之处是本地运行、不绑定特定 agent、不收费。
  2. 迭代快,所以不稳。 6 周里两次破坏性重写(Rust TUI → TS 看板 → GUI Web),482 次 commit,而且很多是 agent 自己提交的。好处是反馈闭环极快,坏处是用户的使用习惯和配置不断被推翻,文档和行为也经常对不上(误报 needs you、状态卡死这类 issue)。
  3. 安全模型靠"软约束"。 Codex 默认全权限,review 也只是另一个 LLM 的判断。用在个人项目或内部工具上问题不大;团队仓库、生产代码建议把 Merge 设为 "ask me first",关掉 Autopilot,并先解决 review 结果与 commit 绑定的问题。
  4. 适合谁:已经深度用 herdr、同时跑 3 个以上 agent、想在手机上审批或回答问题的人。只把 herdr 当 multiplexer 用、或者 token 预算紧张的人,未必划算。
  5. 值得关注:全插件化能不能形成生态(作者的设想是"让 agent 给你写插件");review 能否绑定 commit hash;以及 Claude Projects 全面开放给 CLI 用户之后,这类第三方 mission control 还有多大空间。

参考链接

作者主线推文

代码与文档

书签里的相关 herdr 生态推文

Reddit

Read this report as Markdown · Cite it (BibTeX)