You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 94f8ffd
Browse filesBrowse the repository at this point in the historyBrowse files
cargo build --release # the program, in target/release/herdr-projects
78
+
herdr plugin link "$PWD"# hooks, the board's tab and the actions
79
+
sh bin/run.sh install # writes its launcher, says how to put it on your PATH
80
+
```
81
+
82
+
Every command Herdr runs for the plugin goes through `bin/run.sh`, which runs `target/release/herdr-projects` while no
83
+
source file is newer than it. Then open the board ([get started](docs/get-started.md)).
84
+
85
+
**Updating** is `git pull`, then `cargo build --release` again; an open board and the keeper load the new program by
86
+
themselves. Build right after each pull: while the build is older than its source, `bin/run.sh` falls back to
87
+
upstream's v1.2.27 program, downloaded, which has none of the changes above. `herdr-projects update` is no use here:
88
+
it downloads upstream's releases, not this copy (this repo publishes none, and upstream's newest are Shepherdr's), and
89
+
a program built from source refuses it anyway.
90
+
91
+
`herdr plugin install eliasstravik/herdr-projects` installs upstream, now Shepherdr. A `herdr plugin install` of this
92
+
repo would get upstream's prebuilt 1.2.27 program in its build step instead of building this copy: use a checkout as
93
+
above. [Installing](docs/install.md) has the details.
94
+
95
+
---
96
+
1
97
<palign="center"><imgsrc="https://img.shields.io/badge/Herdr%20Projects-Mission%20control%20for%20Herdr-2ea44f?style=flat-square&labelColor=24292f"alt="Herdr Projects | Mission control for Herdr" /></p>
2
98
3
99
<h3align="center">Run dozens of coding agents through one Coordinator without micromanaging each one or losing sight of what needs you</h3>
4
100
5
101
<palign="center">Herdr Projects is mission control for <ahref="https://herdr.dev">Herdr</a>: one list of tasks, yours and the ones you delegate. You type what needs doing and the board's own agent, the Coordinator, turns it into tasks. Every delegated task runs as an ordinary Herdr agent in its own space and worktree, gets checked and reviewed by a second agent when it finishes, and waits for your yes before it merges. The board shows which tasks need you, which are ready to approve and which are still working.</p>
6
102
7
-
<palign="center"><ahref="https://github.com/eliasstravik/herdr-projects/blob/main/assets/herdr-projects-launch.mp4"><imgsrc="assets/herdr-projects-launch.webp"width="88%"alt="Animation: you tell the Coordinator what you want, it adds tasks that each get an agent on their own branch, and the board groups them as needs you, ready to approve, and working" /></a></p>
103
+
<palign="center"><ahref="https://github.com/jbutton/herdr-projects-legacy/blob/main/assets/herdr-projects-launch.mp4"><imgsrc="assets/herdr-projects-launch.webp"width="88%"alt="Animation: you tell the Coordinator what you want, it adds tasks that each get an agent on their own branch, and the board groups them as needs you, ready to approve, and working" /></a></p>
@@ -50,7 +146,7 @@ An agent that asks you something, wants a permission or a sign-in says so to the
50
146
51
147
<table>
52
148
<tr>
53
-
<tdalign="center"valign="top"width="33%"><h3>1️⃣</h3><b>Install the plugin</b><br /><sub>Run <code>herdr plugin install eliasstravik/herdr-projects</code>. It downloads the one program for your platform: no Node, no npm.</sub></td>
149
+
<tdalign="center"valign="top"width="33%"><h3>1️⃣</h3><b>Build and link the plugin</b><br /><sub>In a clone of this repo, run <code>cargo build --release</code> and <code>herdr plugin link "$PWD"</code> (<ahref="#install-and-update-this-copy">install and update</a>). It is one program: no Node, no npm.</sub></td>
54
150
<tdalign="center"valign="top"width="33%"><h3>2️⃣</h3><b>Open the board</b><br /><sub>Run the plugin's action "Open the work board", or <code>herdr plugin action invoke open --plugin herdr-projects</code> in a Herdr pane. Its first screen offers a key that opens it from anywhere in Herdr.</sub></td>
55
151
<tdalign="center"valign="top"width="33%"><h3>3️⃣</h3><b>Type what needs doing</b><br /><sub>Press <code>Enter</code> and the Coordinator makes it a task, or <code>Tab</code> and each task gets an agent at once. <code>?</code> shows everything else you can do.</sub></td>
56
152
</tr>
@@ -63,24 +159,23 @@ An agent that asks you something, wants a permission or a sign-in says so to the
63
159
<tdalign="center"valign="top"><sub>For developers who run coding agents in Herdr on macOS or Linux</sub><br /><h2>Free</h2><divalign="left"> ✓ A Coordinator that turns what you type into tasks<br /> ✓ Every task on its own worktree and branch, in its own Herdr space<br /> ✓ A check and a second agent's review before anything merges<br /> ✓ What needs you, on the board, in Herdr's sidebar and on your phone<br /> ✓ Branches kept up to date with main, cleanup after a merge<br /> ✓ Plans, attempts, limits, fallback agents and automations</div></td>
herdr-projects update # put the newest release in place of the program
74
-
herdr-projects update 1.2.0 # a given version
169
+
git pull && cargo build --release # in your checkout of this repo
75
170
```
76
171
77
-
An open board and the keeper see the new program and load it by themselves, once nothing is half typed and no agent is held up. Pulling a newer plugin with `git pull` does the same at the next command Herdr runs. A program you built yourself is updated with `git pull` and `cargo build --release`, never by a download. [Installing](docs/install.md) has the details.
172
+
An open board and the keeper see the new program and load it by themselves, once nothing is half typed and no agent is held up. This copy publishes no releases, so `herdr-projects update`is no use here ([install and update this copy](#install-and-update-this-copy)). [Installing](docs/install.md) has the details.
78
173
79
174
## Get your questions answered
80
175
81
176
### Do I need to know how to code?
82
177
83
-
You need to be comfortable in a terminal. The plugin downloads one prebuilt program for your platform, and you never have to edit its files: everything changes by asking the Coordinator or from the board's settings page (`Ctrl+E`). You'll need macOS or Linux, Herdr 0.9.3 or newer, Git, `curl` or `wget`, and an agent CLI the board can start: Claude Code, Codex, pi or another agent herdr supports. `gh` (pull requests) and `tailscale` (private review links) are optional. Rust/Cargo is needed only when you build it yourself. [Installing](docs/install.md) covers the prerequisites.
178
+
You need to be comfortable in a terminal. This copy is built once from source with one command, and you never have to edit its files: everything changes by asking the Coordinator or from the board's settings page (`Ctrl+E`). You'll need macOS or Linux, Herdr 0.9.3 or newer, Git, Rust/Cargo, and an agent CLI the board can start: Claude Code, Codex, pi or another agent herdr supports. `gh` (pull requests) and `tailscale` (private review links) are optional. [Installing](docs/install.md) covers the prerequisites.
84
179
85
180
### How do I check that Herdr Projects is running?
86
181
@@ -128,6 +223,6 @@ Herdr Projects is free and [MIT licensed](LICENSE). Your agent CLI's usual usage
128
223
129
224
<palign="center">Your board starts with an install, one key, and one sentence about what needs doing. Herdr Projects starts the agents, checks their work and keeps it in view. You choose what to answer and what to merge.</p>
if w.len() == 1 && w[0] == "none"{returnOk(json!("none"));}
25
-
if w.is_empty(){returnrefuse(format!("{name} is one or more of done, stuck, added, or none."));}
26
-
ifletSome(bad) = w.iter().find(|x| !EVENTS.contains(&x.as_str())){returnrefuse(format!("{name}: \"{bad}\" is not an event autopilot wakes on. One or more of: done, stuck, added; or none."));}
25
+
if w.is_empty(){returnrefuse(format!("{name} is one or more of done, stuck, stalled, added, or none."));}
26
+
ifletSome(bad) = w.iter().find(|x| !EVENTS.contains(&x.as_str())){returnrefuse(format!("{name}: \"{bad}\" is not an event autopilot wakes on. One or more of: done, stuck, stalled, added; or none."));}
27
27
Ok(json!(EVENTS.iter().filter(|x| w.iter().any(|y| y == *x)).copied().collect::<Vec<_>>().join(" ")))
0 commit comments