# herdr notes

> Source: <https://gist.github.com/bradflaugher/99f364cee8ee6ad2f65360839eb3961b>
> Published: 2026-09-08 18:31:15+00:00

The whole product is three steps:

1. Open Herdr in the repo.
2. Open the agents you want in other panes.
3. Tell the lead to talk to them with the Herdr CLI.

The skill is the how-to. The prompt is the job.

One integration per agent:

```
herdr integration install claude
herdr integration install codex
herdr integration install grok
herdr integration install kimi
herdr integration install antigravity-cli   # agy
```

Teach the lead the CLI:

```
npx skills add herdrdev/herdr --skill herdr -g
```

Without the skill, the lead often invents MCP or ignores the other panes.

```
cd <repo>
herdr
```

Open a window for each agent:

- New tab: click `+` , or prefix then`c`
- Split: right-click the pane frame, or prefix then `v`

Start each helper in its own pane, optionally with that CLI's skip-permissions flag:

| Agent | Flag | 
|---|---|
| claude, agy | `--dangerously-skip-permissions` | 
| codex, grok, kimi | `--yolo` | 

Then:

```
herdr agent list
```

Use those names exactly. Do not open every agent for every task. Two helpers plus a lead is enough.

The lead must be running *inside* Herdr (`HERDR_ENV=1`). Copy names from the list. Do not put the lead on the call list.

Paste into the lead. Swap roles and the task. Need `gh` logged in (`gh auth status`) for the PR step.

```
You are the lead. Use the herdr CLI to talk to the other agents
in this session. Run `herdr agent list` if you need names.
Do not invent MCP, subagents, or tmux.

grok — <role>
codex — <role>
Only <writer> edits files.

Task: <one sentence>

Git:
- New branch off main. Commit when the work is done.
- Open a PR. Do not merge. Do not push to main.

Stop when the PR URL exists. Paste it.
```

Use this when the lead does the work itself, cannot see the other panes, or sits on `agent_blocked`.

```
Stop. You are inside Herdr. Use only the herdr CLI.

1. herdr agent list
2. Talk only to those names:
   herdr agent prompt <name> "<job>" --wait --timeout 300000
   herdr agent read <name> --source recent-unwrapped --lines 200
3. If the command returns agent_blocked: do not retry.
   Tell me the pane and wait.
4. If HERDR_ENV is not 1, say so and stop.

Git still: branch, commit, PR. No merge.
Then continue the task.
```

| What you want | What to do | 
|---|---|
| Leave, keep agents running | `Ctrl+Space` , then`d` (Omarchy). Stock Herdr: prefix then`q` . Closing the window is the same. | 
| Kill the session | `herdr server stop` | 
| `prefix+x` closes a pane.`prefix+k` closes a tab. Neither stops the server. |  | 
| Reattach later | `herdr` or`Super+Ctrl+Return` |