Every role can use any program Herdr can start and has its own integration for. Claude Code, Codex and pi do everything the board does. The others work too, with a few limits (below).
herdr-projects set reviewer.agent agy/gemini-3-pro
herdr-projects set worker.fallback "codex, copilot/gpt-5.5"
herdr-projects delegate 12 --worker.agent qwen --reviewer.agent cursor
A model goes after a slash (models and effort). The settings that pick a program are worker.agent,
reviewer.agent, coordinator.agent, watcher.agent, plan.agent, worker.fallback, reviewer.fallback and
attempts.by.
The programs: Claude Code (claude), Codex (codex), pi (pi), Antigravity CLI (agy), GitHub Copilot CLI
(copilot), Cursor Agent (cursor), Devin (devin), Factory's Droid (droid), Grok (grok), Hermes (hermes),
Kilo Code (kilo), Kimi Code (kimi), Letta Code (letta), MastraCode (mastracode), oh-my-pi (omp), OpenCode
(opencode), Qoder (qodercli) and Qwen Code (qwen). Herdr's integration name and the program's own name work too
(antigravity-cli is agy, cursor-agent is cursor).
Start it once yourself, in a terminal, in a folder of a repo: log in, finish its first setup, and trust the folder if it asks.
Why: Herdr reads a login page as a program at rest, so the board types the task into a logged-out program as if it were ready. Cursor, Devin, Grok, agy and Letta all came up at a login or setup page when tried here.
A folder-trust dialog in a new worktree is a dialog like any other: the task waits for you (needs you). Claude Code,
Codex and pi are told beforehand to trust it (how work gets done). For Codex the board adds a
[projects."<repo>"] table to ~/.codex/config.toml, only when the file reads and has no entry for the repo in any
form (any quotes, a dotted key); an entry that says untrusted is left as it is. pi trusts a folder and the folders
in it, and asks only where the folder has pi settings of its own (.pi/settings.json, .pi/extensions, …): the board
adds the folder pi starts in (the task's worktree) to ~/.pi/agent/trust.json, unless pi has a decision for it or a
folder above it, the file does not read, or pi is writing it.
If a start still fails, the task says why: when an agent could not start.
As Herdr starts it (herdr agent start --kind <name>), with the board's own arguments after it. Herdr finds it in its
pane and says whether it works or waits.
The table at the end says, for each program, how it is started and what it can do. It is made from the code
(crates/core/src/agents/kinds/), so it always matches what the board does. Adding a program is one more entry there.
An agent on a task uses its program's own helpers (Claude Code's subagents, Codex's spawned agents, opencode's tasks,
and skills that use them) as it would outside the board. The board's arguments limit no tool, and its rules say only
that the work is not handed on to another task or agent on the board: helpers are named as allowed, also when the task
or a skill asks for them. Told only "never hand it to anyone else", Claude and Codex took that as no helpers and
refused them even when the task asked (HP-53). A test holds both: tests/agent_helpers.rs.
The board reads the conversations Claude Code, Codex and pi save. So it knows what they said, what went wrong with the provider, and how many tokens they used (how work gets done).
It reads no other program's conversation. For those, each of these comes from somewhere else:
- A turn's end comes from Herdr: the program was at work and is at rest again (its
completion_seq). - What the agent said is its closing note, the file the board tells every agent to write when it stops. One
that stops without it waits as
Stopped without a summary, with the last words on its screen. - A review ends with the reviewer's verdict file, as for every program. A reviewer that stops without one ends its round as soon as Herdr sees it stop (15 seconds later), not after the review's whole time.
- The chat with the agent shows the words on its screen, not its conversation (the board).
- Started again (after you stopped it, or after a plan's yes), it reopens its conversation where it can: by the id
Herdr's integration reports (install it:
herdr integration install <name>), or by an id the board gave it at start (copilot, grok, qodercli and qwen take one). Without either it starts a new conversation with the task and what it said last. - The standing rules go in its first prompt, except for a program that takes a rules file at start (droid, omp).
What these programs do not get:
- Tokens are not counted (
limit.tokenssaysdoes nothingfor them). - A provider's passing error is not told from a lasting one. So the board does not wait and try again, and the fallback does not take over for it. A logged-out screen still hands over.
- Helpers the agent starts are not followed.
A program that cannot do a role well is refused when you set it, with the reason and the programs that can:
- MastraCode works on no task (
worker,reviewer,coordinator,plan, the fallbacks and attempts). It can be told neither its model nor to work without asking when it starts (only through environment variables, which Herdr's start cannot set). And it reopens its folder's last conversation, so a reviewer would join the worker's. It can be the Watcher. - The Watcher needs a headless one-shot: a command that answers once and ends. Every program here has one; a program without one would be refused.
- A model for a program that takes none when started for work: Droid. Choose its model in Droid's own settings. Its
one-shot does take one, so
watcher.agent droid/<model>works. - A model name the program does not take, with the names it does. They are read from the program's own list where
it has one (
codex debug models,pi --list-models,cursor-agent models,opencode models), else from the names written in the table (Claude Code).herdr-projects modelslists them (models and effort). - An effort the program does not have: a level not on the list the program gives (Codex's catalog, for the model;
the others'
--help; the table's where it cannot be read), or any level where it takes none at start (most of Herdr's others). Cursor takes its effort in the model's name:cursor/claude-opus-4-8[effort=high]. access askfor a program that never asks before it acts (pi).access autofor a program with no auto mode of its own (all but Claude Code, Codex, Cursor, Qwen Code and Qoder), and at the start, for a version older than its first (auto mode).
Two more are said when the program starts, not when it is set:
- omp and MastraCode need Herdr's own integration, or Herdr cannot tell whether they work. The board does not
install it into your agent's settings. It tells you to:
omp needs herdr's own integration, or herdr cannot see when it works: run herdr integration install omp, then try again. - A program Herdr cannot see. Kilo Code and Qoder installed with npm run behind a small node launcher that starts
the real program as its child, and Herdr 0.9.3 does not find them in the pane. The start fails with
herdr did not see kilo come up in its pane …. Install the program's standalone build instead (tried: Kilo's own binary is found at once).
Herdr also starts Gemini CLI, Cline, Kiro, Amp, Maki and Muse, but has no integration for them (it calls them less tested). The board does not take them. Each would be one more entry in the table.
| Program | Started for work as | Model | Effort | Asking first | Auto mode | Standing rules | Reopened by | Watcher's one-shot | Turn's end read from | herdr's integration | Can do | Checked |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
claude |
claude --dangerously-skip-permissions |
--model <model>; default, fable, opus, sonnet, haiku, opusplan or one of its full names in the table (claude-fable-5-2, claude-fable-5-1, claude-fable-5) |
--effort <level>; the levels claude --help lists, else low, medium, high, xhigh, max |
its own default | --permission-mode auto, from 2.1.111 |
--append-system-prompt-file <file> |
--resume <id> |
claude -p --no-session-persistence --tools "", the prompt on its input |
its conversation file | claude |
every role | everything the board does, on 2.1.296 to 2.1.300 |
codex |
codex --dangerously-bypass-approvals-and-sandbox --no-daemon |
-m <model>; the names codex debug models lists |
-c model_reasoning_effort="<level>"; the levels codex debug models lists for the model, else low, medium, high, xhigh, max, ultra |
--no-daemon |
--approve-for-me --no-daemon, from 0.147.0 |
-c developer_instructions=… |
resume <id> |
codex exec --skip-git-repo-check --ephemeral --color never <prompt> |
its conversation file | codex |
every role | everything the board does, on 0.153.4 to 0.162.1 |
pi |
pi |
--model <model>; the names pi --list-models lists |
--thinking <level>; the levels pi --help lists, else off, minimal, low, medium, high, xhigh, max |
cannot ask | none | --append-system-prompt <file> |
--session-id <id> |
pi -p --no-session --no-tools --no-skills --no-context-files -- <prompt> |
its conversation file | pi |
every role | everything the board does, on 1.1.0 |
agy (also antigravity-cli, antigravity) |
agy --dangerously-skip-permissions |
--model <model>; not checked |
--effort <level>; the levels agy --help lists, else low, medium, high, xhigh, max |
its own default | none | in its first prompt | --conversation <id> |
agy --disable-slash-commands -p <prompt> |
herdr's state and its closing note | antigravity-cli |
every role | flags from agy --help 1.3.6; started by herdr 0.9.3 on the board's flags (it came up at its login) |
copilot |
copilot --yolo |
--model <model>; not checked |
--reasoning-effort <level>; the levels copilot --help lists, else none, minimal, low, medium, high, xhigh, max |
its own default | none | in its first prompt | --resume=<id> |
copilot -s --no-custom-instructions --no-ask-user --allow-all-tools -p <prompt> |
herdr's state and its closing note | copilot |
every role | flags from copilot --help 1.0.98; started by herdr 0.9.3 on the board's flags (its folder-trust dialog) |
cursor (also cursor-agent) |
cursor-agent --yolo |
--model <model>; the names cursor-agent models lists |
cursor takes its effort in the model's name: cursor/claude-opus-4-8[effort=high] | its own default | --auto-review, from 2026.06.22 |
in its first prompt | --resume <id> |
cursor-agent -p --output-format text --mode ask --trust <prompt> |
herdr's state and its closing note | cursor |
every role | flags from cursor-agent --help 2026.10.01; started by herdr 0.9.3 on the board's flags, given a task |
devin |
devin --permission-mode dangerous |
--model <model>; not checked |
none | its own default | none | in its first prompt | --resume <id> |
devin --respect-workspace-trust false -p <prompt> |
herdr's state and its closing note | devin |
every role | flags from devin --help 3000.11.92; started by herdr 0.9.3 on the board's flags (it came up at its login) |
droid |
droid --auto high |
none at start | none | its own default | none | --append-system-prompt-file <file> |
--resume <id> |
droid exec <prompt> |
herdr's state and its closing note | droid |
every role | flags from droid --help 0.235.0; a task on 0.242.0 in herdr 0.9.3: started, prompted and its turn's end seen |
grok |
grok --always-approve |
-m <model>; not checked |
--reasoning-effort <level>; the levels grok --help lists, else any level |
its own default | none | in its first prompt | --resume <id> |
grok -p <prompt> |
herdr's state and its closing note | grok |
every role | flags from grok --help 1.0.52; started by herdr 0.9.3 on the board's flags (it came up at its login) |
hermes |
hermes chat --yolo |
-m <model>; not checked |
none | its own default | none | in its first prompt | --resume <id> |
hermes --ignore-rules -z <prompt> |
herdr's state and its closing note | hermes |
every role | flags from hermes --help 0.19.0; started by herdr 0.9.3 on the board's flags (its first setup) |
kilo |
kilo --auto |
-m <model>; not checked |
none | its own default | none | in its first prompt | --session <id> |
kilo run <prompt> |
herdr's state and its closing note | kilo |
every role | flags from kilo --help 7.8.12; started by herdr 0.9.3 on the board's flags as its own program (npm's launcher hides it from herdr) |
kimi |
kimi --auto |
-m <model>; not checked |
none | its own default | none | in its first prompt | --session <id> |
kimi -p <prompt> |
herdr's state and its closing note | kimi |
every role | flags from kimi --help 2.2.0; started by herdr 0.9.3 on the board's flags (its folder-trust dialog) |
letta |
letta --new --yolo |
-m <model>; not checked |
none | its own default | none | in its first prompt | --conversation <id> |
letta --ephemeral -p <prompt> |
herdr's state and its closing note | letta |
every role | flags from letta --help 0.34.15; started by herdr 0.9.3 on the board's flags (its first setup held it) |
mastracode |
mastracode |
none at start | none | its own default | none | in its first prompt | starts afresh | mastracode --permission-mode deny --prompt <prompt> |
herdr's state and its closing note | mastracode, needed |
Watcher only: mastracode can be told neither its model nor to work without asking when it starts (only through environment variables, which herdr's start cannot set), and it reopens its folder's last conversation, so it cannot work on a task: it can be the Watcher | flags from mastracode's own source 0.47.0 |
omp |
omp --auto-approve |
--model=<model>; not checked |
--thinking=<level>; the levels omp --help lists, else off, minimal, low, medium, high, xhigh, max, auto |
--approval-mode=write |
none | --append-system-prompt=<file> |
--resume=<id> |
omp -p --no-session --no-tools --no-skills --no-rules <prompt> |
herdr's state and its closing note | omp, needed |
every role | flags from omp --help 18.11.1; started by herdr 0.9.3 on the board's flags (its first setup) |
opencode |
opencode --auto |
-m <model>; the names opencode models lists |
none | its own default | none | in its first prompt | --session <id> |
opencode run <prompt> |
herdr's state and its closing note | opencode |
every role | flags from opencode --help 1.18.34; started by herdr 0.9.3 on the board's flags; OpenCode 2.1.4's conversation made on a model and opened by hand |
qodercli |
qodercli --dangerously-skip-permissions |
-m <model>; not checked |
--reasoning-effort <level>; the levels qodercli --help lists, else any level |
its own default | --permission-mode auto, from 0.2.14 |
in its first prompt | --resume <id> |
qodercli -p --no-session-persistence --tools "" -- <prompt> |
herdr's state and its closing note | qodercli |
every role | flags from qodercli --help 1.1.72; npm's launcher hid it from herdr 0.9.3 |
qwen |
qwen --yolo |
-m <model>; not checked |
none | its own default | --approval-mode auto, from 0.16.0 |
in its first prompt | --resume <id> |
qwen -p <prompt> |
herdr's state and its closing note | qwen |
every role | flags from qwen --help 0.25.2; started by herdr 0.9.3 on the board's flags |