eliasstravik/herdr-projects

Herdr Projects – 协调多个编码代理以完成单一任务

是什么

• 专为 Herdr AI 编码环境（macOS / Linux，Herdr 0.9.1+）设计的免费 MIT 许可证插件。
• 添加一个 协调器 代理，允许你启动一个由多个独立代理线程组成的“项目”，每个子任务在独立的 Git worktree/branch（或文件夹）中运行。
• 你在与协调器的单一对话中保持沟通，而线程并行运行，Herdr 侧边栏按状态（需要你、正在工作、准备审查等）对它们进行分组。

为何使用它

• 当任务太大而无法由一个编码代理完成时，你可以自动将其拆分为多个代理，而不是手动启动和跟踪每个代理。
• 协调器从不承担繁重工作，因此能始终保持响应你的问题。
• 所有线程共享相同的目标、指令和记忆，确保整个项目的一致性。
• 无需托管服务——所有内容都保存在你自己的机器上，或你通过 SSH 访问的机器上。

主要功能

功能	你将获得
并行执行	每个任务在独立的 Git worktree/branch（或文件夹）中运行，实现工作并发。
单一聊天	仅需与协调器对话；它会转发进展报告，并在某个线程需要你时请求输入。
侧边栏概览	线程以行形式显示，包含 ID、标题和状态标签（如 review · PR #4、~40%）。
自动线程生命周期	PR 合并后或线程空闲超过可配置时间段后，插件会清理 worktree/branch，并将报告复制到安全位置。
兼容任意 Herdr 兼容代理	Claude Code、Codex、OpenCode 或任何 Herdr 可启动的 CLI 代理。
无额外费用	所有功能免费；你仅需支付底层代理模型的正常使用成本。
可配置安全性	细粒度允许列表，控制协调器可让代理执行的操作；可选“yolo”模式自动批准。
CLI 优先工作流	使用 herdr plugin install eliasstravik/herdr-projects 安装，然后使用 herdr-projects new、herdr-projects open、herdr-projects thread start 等命令。

工作原理（高层次流程）

1. 安装与配置 – herdr plugin install … 下载预构建二进制文件；herdr-projects configure 设置侧边栏行、弹出快捷键和 /autoproject 技能。
2. 创建项目 – herdr-projects new "Billing" --repo ~/dev/app 在 ~/.herdr-projects/ 下创建一个包含 Markdown/TOML 文件（PROJECT.md、AGENTS.md、MEMORY.md 等）的文件夹。
3. 与协调器对话 – 在协调器面板中描述总体目标。协调器提出一组线程（每个线程是一个独立的代理任务），等待你的批准。
4. 线程运行 – 批准的线程在各自的 Git worktree/branch（或文件夹）中启动并执行代理 CLI。它们报告进度、提出问题，并在需要时打开 PR。
5. 你保持在环中 – 侧边栏突出显示需要你的线程；你可直接在 Herdr 中回答、审查或合并 PR。
6. 清理 – 线程完成后，插件会删除其 worktree/branch（除非有未提交的更改），并归档报告。

快速入门（三步速查表）

步骤	命令	作用
1️⃣ 安装	herdr plugin install eliasstravik/herdr-projects herdr-projects configure	下载二进制文件，注册侧边栏行和弹出快捷键。
2️⃣ 创建	herdr-projects new "MyProject" --repo ~/dev/myrepo herdr-projects open myproject	设置项目目录并启动协调器代理。
3️⃣ 描述	在协调器面板中输入高层次描述并确认建议的线程。	协调器启动并行代理；你可在侧边栏中监控其状态。

数据存储位置

• 项目文件夹：~/.herdr-projects/<name>/（包含 PROJECT.md、AGENTS.md、MEMORY.md、TASKS.md、threads/、library/ 等）。
• 配置与安全设置：~/.config/herdr-projects/config.toml（项目外部，代理不会编辑）。

更新

• 运行 herdr-projects update（或 --check 仅查看版本）。该命令获取最新二进制文件，运行 doctor --fix，并重启后台计时器以维持项目活跃。

安全与权限

• 协调器运行 herdr-projects 二进制文件；你应该按子命令允许列表，而不是原始二进制文件。典型允许操作：skill、context、report、thread list、thread prompt 等。更严格的操作（如 thread resolve、sweep）仍需通过正常代理权限提示。
• 插件从不自行推送或合并代码；合并仅在某个线程显式运行“合并 PR”命令时发生。

谁应该使用它

• 熟悉终端并已使用 Herdr 进行 AI 辅助编码的开发者。
• 需要将大型功能拆分为多个独立 AI 驱动子任务，同时保持单一交互点的团队。
• 希望获得完全本地化、免费解决方案，无需托管项目管理服务的人。

许可证

• MIT 许可证 – 你可以自由使用、修改和重新分发该插件。

---

以上所有细节均直接取自仓库的 README；未推断任何额外功能。