P
petekp/coordinator
Turn one Claude Code session into a coordinator that runs, watches and cleans up a fleet of agent sessions in Herdr.
★ 46·更新 2026-11-17
在 GitHub 查看 ↗链接已于 2026-11-17 核查 · HTTP 200 · 打开的是厂商自己的官网
- ★ 数取值
- 46 ★ · petekp/coordinator · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 从该仓库的 GitHub 页面直接读取 · 条目类型:开源项目
- 收录与活跃
- 收录于 2026-11-17 · 最近见到 2026-11-20 · 共见到 4 次 · 被 1 个来源列出
- 评分构成
- 综合分 103 · 46 ★ · 1 个来源 · repo
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: 开源项目。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
petekp/coordinator;我们收录于 2026-11-17;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
# Coordinator
以下摘录自该仓库的 README(片段)
### A higher-level agentic workflow for Claude Code and Herdr
Coordinator turns one coding-agent session into a manager for a body of
work. You give it a domain, such as a repo or a product area, and send it
requests as they come up. It writes a brief for each task and starts a
separate agent session to do it, in its own Git worktree and its own tab.
It watches those sessions, relays their questions to you, checks their
work, and cleans up when a task lands. You talk to one session, and up to
three others work in parallel.
It is a pair of skills for Claude Code,
with Python scripts that drive Herdr. Herdr runs each
agent in a terminal that stays alive and shows them all in one app.
## How it works
The coordinator is a Claude Code session you start with
/coordinator . It owns one domain and keeps its state in a
Markdown backlog file: what the domain covers, what you approved for
good, what is open, and what is done. The backlog is what survives a
restart.
Delegates are the sessions it starts, one per task. Each gets a Git
worktree, a brief that says what done looks like and where to stop, and a
tab in the Herdr app listed under the coordinator. A delegate writes a
REPORT.md when it stops.
The watcher, fleet_watch.py, runs in the background and wakes the
coordinator when a delegate finishes, asks something or gets stuck. It
also wakes it when a pull request is merged, fails its checks or gets a
review.
The cap check keeps at most three delegates working at once, and can
hold the number of open pull requests in a repo under a limit you set.
Quiet delegates are ended after a day without a response, and resumed
with the same session when something arrives for them.
fleet-sweep, the second skill, removes finished worktrees, branches,
tabs and stray processes. It refuses anything that would lose work and
asks you about it.
The coordinator decides small, reversible things on its own and says what
it chose. It asks you when the answer changes what gets built, costs time
or money, reaches other people, or is a matter of taste. Questions arrive in
batches of at most five, each with its options and a recommendation.
## Requirements
| Tool | Why |
| herdr-core (hc) | runs every agent in a terminal that outlives the app |
| Herdr app (herdr-app) | shows each delegate in its own tab |
| Claude Code | runs the coordinator and its delegates |
| Python 3.9 or newer | runs the scripts, which use only the standard library |
| git | worktrees and branches |
| gh, signed in | pull request status, for domains with a GitHub repo |
Optional:
Codex can take small, mechanical
delegate tasks.
The inbox mod for Claude Code collects
every question in one pane. The scripts read its saved questions when it
is installed.
The Coordinator layout for Herdr is in herdr/, described under
Herdr sidebar.
Tested on macOS with herdr-core 0.1.21, the Herdr app 0.1.15, Claude Code
2.1.325 and Codex 0.164.0.
Install herdr-core with:
sh
curl -fsSL https://releases.herdr.dev/core/install.sh | sh
and download the Herdr app from herdr.dev.
## Install
To have an agent do it, paste this into Claude Code:
Set up the coordinator workflow by following https://raw.githubusercontent.com/petekp/coordinator/main/SETUP.md
Coordinator turns one coding-agent session into a manager for a body of
work. You give it a domain, such as a repo or a product area, and send it
requests as they come up. It writes a brief for each task and starts a
separate agent session to do it, in its own Git worktree and its own tab.
It watches those sessions, relays their questions to you, checks their
work, and cleans up when a task lands. You talk to one session, and up to
three others work in parallel.
It is a pair of skills for Claude Code,
with Python scripts that drive Herdr. Herdr runs each
agent in a terminal that stays alive and shows them all in one app.
## How it works
The coordinator is a Claude Code session you start with
/coordinator . It owns one domain and keeps its state in a
Markdown backlog file: what the domain covers, what you approved for
good, what is open, and what is done. The backlog is what survives a
restart.
Delegates are the sessions it starts, one per task. Each gets a Git
worktree, a brief that says what done looks like and where to stop, and a
tab in the Herdr app listed under the coordinator. A delegate writes a
REPORT.md when it stops.
The watcher, fleet_watch.py, runs in the background and wakes the
coordinator when a delegate finishes, asks something or gets stuck. It
also wakes it when a pull request is merged, fails its checks or gets a
review.
The cap check keeps at most three delegates working at once, and can
hold the number of open pull requests in a repo under a limit you set.
Quiet delegates are ended after a day without a response, and resumed
with the same session when something arrives for them.
fleet-sweep, the second skill, removes finished worktrees, branches,
tabs and stray processes. It refuses anything that would lose work and
asks you about it.
The coordinator decides small, reversible things on its own and says what
it chose. It asks you when the answer changes what gets built, costs time
or money, reaches other people, or is a matter of taste. Questions arrive in
batches of at most five, each with its options and a recommendation.
## Requirements
| Tool | Why |
| herdr-core (hc) | runs every agent in a terminal that outlives the app |
| Herdr app (herdr-app) | shows each delegate in its own tab |
| Claude Code | runs the coordinator and its delegates |
| Python 3.9 or newer | runs the scripts, which use only the standard library |
| git | worktrees and branches |
| gh, signed in | pull request status, for domains with a GitHub repo |
Optional:
Codex can take small, mechanical
delegate tasks.
The inbox mod for Claude Code collects
every question in one pane. The scripts read its saved questions when it
is installed.
The Coordinator layout for Herdr is in herdr/, described under
Herdr sidebar.
Tested on macOS with herdr-core 0.1.21, the Herdr app 0.1.15, Claude Code
2.1.325 and Codex 0.164.0.
Install herdr-core with:
sh
curl -fsSL https://releases.herdr.dev/core/install.sh | sh
and download the Herdr app from herdr.dev.
## Install
To have an agent do it, paste this into Claude Code:
Set up the coordinator workflow by following https://raw.githubusercontent.com/petekp/coordinator/main/SETUP.md
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/petekp-coordinator/)
- 来源
- github · https://github.com/petekp/coordinator
- 按领域浏览
- 开源项目
- Traction
- 46 ★
- 收录于
- 今天
更多条目
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。