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
- 它是什么:herdr-projects 是 Elias Stråvik(@eliasstravik)给 herdr(面向 coding agent 的终端复用器)写的插件,是 herdr 版的 "Claude Projects"。你只跟一个 coordinator agent 对话,它把需求拆成任务,每个任务由一个独立 agent(Claude Code / Codex / pi 等)在自己的 git worktree + 分支里干活,干完由第二个 agent review,再合并。
- 6 周 3 次重写:9/18 发布 → 10/16 v1 从零重写成"任务看板" → 10/29 v2 改名 Shepherdr,从 TUI 换成能在手机、平板、桌面打开的 GUI Web 应用(走 tailnet,不公开)。
- 数据:eliasstravik/shepherdr 932★ / 89 fork / 482 commits / 444 个 issue+PR,MIT,TypeScript。herdr 插件市场的本周增长榜上有它(852 → 924★)。作者说上线一周内就进了 herdr 插件历史前 10。
- v2 卖点:每个 project 变成 space,各带一个 coordinator;第二个 agent review 后自动合并(也可以设成等你点头);agent 需要你时弹卡片;多机器统一管理;ElevenLabs 语音通话;所有功能都是插件,用户自己的插件放在
~/.shepherdr/plugins/,升级时不会被覆盖。 - 社区主要顾虑:review 通过后 main 又变了,旧的通过还算不算数;强制 worktree / 固定工作流;token 消耗;上手难;任务误报 "needs you";无人值守自动合并的风险。
- 注意重名:GitHub 和 X 上至少还有 3 个不相干的 "shepherdr"(见第 7 节),搜索时别搞混。
- Reddit:几乎没有直接讨论 herdr-projects 或 Shepherdr 的帖子,讨论基本都在 X 上。
1. 背景:herdr 与 "Projects" 范式
- herdr:给 coding agent 用的终端复用器(类似 tmux,但原生识别 agent 状态,支持鼠标,有 space/tab/pane、插件系统和 remote 多机)。官网显示 46K★,插件市场收录了 1961 个插件。0.9.0(9/8)加了"单客户端管理多台机器"(推文,859K 浏览)。
- 触发点:2026-09-18 Anthropic 发布 Claude Projects:"Projects now run from one conversation… Claude directs parallel threads that keep working after you close your laptop."(@claudeai 被引用)。当天 Elias 发了 herdr-projects,配文 "what they said. but you know - for @herdrdev"(137K 浏览,820 赞)。
- 作者在评论里把它定位为 "herdr 自己的实现,nothing more, nothing less"(回复)。他对 herdr 原生功能和插件分工的解释是:"herdr has spaces for tabs and panes + agents, but no built-in task manager or single mission control pane. that's what herdr-projects gives you"(回复)。
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):
- herdr 是引擎,Shepherdr 只负责总览和遥控。 每个 task 都是普通的 herdr agent,可以随时切到 herdr 里接管。
- 不碰你的 checkout。 task 跑在
work/<n>-<slug>分支的 worktree 里,合并只会让 main 前进(fast-forward;没有 GitHub remote 时用 squash)。新 worktree 会复制.worktreeinclude里列出的被忽略文件(如.env)。 - 没有"新建任务"按钮。 所有任务都由 coordinator 写 brief 生成,每条 brief 末尾带一个 Settings 块(review 轮数、合并策略、agent/model/effort)。想单独定制某个任务,直接用自然语言说:"for later"、"after SHE-12"、"ask me before merging"。
- 状态是 agent 自己报的。 Claude Code 通过 Shepherdr 单独的
--settingshooks 文件上报,不碰你自己的配置;Codex 和 pi 用 herdr 读屏和 OSC 7501 兜底。 - provider 断流自动重试:1/2/4/8 分钟各一次,第 5 次还失败才提示你;agent 额度用完或掉登录时,backup agent(默认 Codex)接手同一个 worktree 继续。
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
- Autopilot 是每个 space 一个的开关,借鉴了 OpenClaw 的 heartbeat 机制。按时间规则(iCalendar RRULE)给 coordinator 发固定 prompt,让它过一遍
HEARTBEAT.md清单,也可以由事件(task ready / needs you / merged / main 变红…)立即唤醒。 - 它会做:回答能从 brief 推出答案的问题、处理 rebase 冲突、修失败的 check、启动排队任务、为 review 发现的问题补小修复任务,出问题太多时自己关掉并告诉你。
- 它不会做:删任务、改 Settings、开没人要的工作、force-push、绕过 "ask me first" 合并。
- Automations 相当于任务版 cron:按时间或事件,用模板新建一个 task,每次都起新 agent。作者自己用它每天 triage 仓库的 issue 和 PR,并自动建任务(推文),也就是"用 herdr-projects 开发 herdr-projects"(推文)。
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 写得很直白)
- Codex 默认全权限(
--dangerously-bypass-approvals-and-sandbox),这样任务不会卡在没人看到的确认提示上。 - Claude Code 和 pi 沿用你自己的权限设置。
- "brief 里的规则和 review 只是 guidance,不是 sandbox"。review 只是另一个 agent 的判断,不能当作证明。如果想让每次合并都等你点头,就把 Merge 设为 "ask me first",并关掉 Autopilot。
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. 我的判断
- 它代表一个方向:从 coding agent 到 coordinator agent。 用户只跟一个 coordinator 对话,执行交给一群"一次性"的 worker,加上隔离(worktree)、独立 review、状态自报、手机审批。Claude Projects 和 Codex 也在往这个方向走,Shepherdr 的不同之处是本地运行、不绑定特定 agent、不收费。
- 迭代快,所以不稳。 6 周里两次破坏性重写(Rust TUI → TS 看板 → GUI Web),482 次 commit,而且很多是 agent 自己提交的。好处是反馈闭环极快,坏处是用户的使用习惯和配置不断被推翻,文档和行为也经常对不上(误报 needs you、状态卡死这类 issue)。
- 安全模型靠"软约束"。 Codex 默认全权限,review 也只是另一个 LLM 的判断。用在个人项目或内部工具上问题不大;团队仓库、生产代码建议把 Merge 设为 "ask me first",关掉 Autopilot,并先解决 review 结果与 commit 绑定的问题。
- 适合谁:已经深度用 herdr、同时跑 3 个以上 agent、想在手机上审批或回答问题的人。只把 herdr 当 multiplexer 用、或者 token 预算紧张的人,未必划算。
- 值得关注:全插件化能不能形成生态(作者的设想是"让 agent 给你写插件");review 能否绑定 commit hash;以及 Claude Projects 全面开放给 CLI 用户之后,这类第三方 mission control 还有多大空间。
参考链接
作者主线推文
- 9/16 herdr-agent-progress
- 9/18 introducing herdr-projects
- 9/24 top 15 + 功能升级
- 9/25 /autoproject
- 10/13 big things are coming
- 10/16 v1 发布
- 10/16 daily triage automation
- 10/19 语音预告
- 10/21 自治软件工厂
- 10/21 next up: autopilot
- 10/26 gui wins
- 10/29 v2 Shepherdr
代码与文档
- eliasstravik/shepherdr(原 herdr-projects,旧链接会重定向)
- docs/get-started.md · docs/tasks.md · docs/autopilot.md · docs/plugins.md · docs/upgrading.md
- 分支:legacy(Rust 0.2.35)· legacy-herdr-projects(1.2.27)
- herdr.dev · herdr 插件市场
书签里的相关 herdr 生态推文
- herdr 0.9.0 多机
- Herdr UI 发布(Fabien Penso)
- herdr web ui v0.4.9(现 Ovis)
- herdrup 移动端
- herdr agent skill:harness 互相调用
- Oliver Jumpertz 的 herdr 工作流
- 全站和 r/herdr 搜索
herdr-projects/shepherdr都没有找到直接讨论的帖子。相关的协调层帖子:Pi Herdsman、coordination layer for Claude Code/Codex/OpenCode/Pi、Multi-agent orchestration with @ mentions