The person with the idea
Writes what "done" looks like, and files the first tasks. Answers a question when an agent asks one.
Doesn't need to read code, or touch the CLI.
When an agent needs your input →Rollout plan
This plan takes about two weeks. Go faster or slower as you like. It does not promise how fast a task ships.
Who does what
One person can hold more than one of these. Make sure someone covers each one before Day 1. If you're the one signing off on this rollout, read the case for it before you read the phases below. A product manager with a team can start at for product teams.
Writes what "done" looks like, and files the first tasks. Answers a question when an agent asks one.
Doesn't need to read code, or touch the CLI.
When an agent needs your input →Connects the first device and the first repository. One-time setup.
Doesn't need to stay involved once that first setup is done.
How do I add a device? →Signs off where a gate asks for it. Answers agent questions on the tasks they approve.
Does not need to read every diff. An agent review stage checks each change before merge and comments on the task. Read that comment first.
Approvals & staying in control →The five phases
Read each phase before you start it. What actually happened decides what comes next.
Day 1 · Technical owner
Connect one device and one repository, so an agent has somewhere to work.
Sign-up is invite-only right now. Request access before you start.
Watch for: A device shows Online only while ch device-server keeps running. A machine that sleeps goes Offline within about a minute.
Done when:
Day 2 · The person with the idea
File one bounded, checkable brief. Watch the herd build it.
Watch for: With a vague brief, the agent asks what "done" means. The task then moves to Blocked with a question. Answer it on the task page.
Done when:
Days 3 to 5 · The approver
Learn what each stage's gate checks for you, before you widen the work.
Watch for: No built-in workflow has an approval gate. Add one to the entry stage (Starter plan or higher). Or turn on a required approval on your git host.
Done when:
Week 2 · Technical owner
Route more than one task to more than one agent, without them colliding.
Watch for: Two tasks that touch the same files can still collide at review, even from separate worktrees.
Done when:
End of week 2 · The person with the idea
Read what the first two weeks cost and shipped. Then price the next month from your own data.
Watch for: After one send-back, the next code run asks for an Opus-tier agent. Rework costs more for that reason.
Done when:
What to hand over first
Small, and easy to check: does the reported bug still happen?
Bounded to one file or package, with a clear, checkable result.
Low risk. A wrong correction is easy for a person to catch and reject.
Routine work, checked against a build or test command you already run.
What to keep back, for now
See /will-it-work and /when-agents-get-it-wrong for the full list of limits.
What to measure
CodeHerder sets no target number and no benchmark. Read your own two weeks. Then decide what good looks like for your team.
ch task show <taskId> prints what a task has cost so far. It also shows where the task stands against any budget you set.
Understanding costs →Every task that changes a repository reports its change shape: how many files, lines, and directories it touched.
Change shape →Each stage transition is on record, including a send-back into code and which stage sent it there.
How work flows →A blocked task carries a reason: who filed it, and when. Some clear on their own; others need you to act.
Blockers and blocked tasks →FAQ
No. This plan takes about two weeks. Go faster or slower as you like. Nothing here times you.
Nobody, unless you set an approval gate yourself. No built-in workflow has one. A gate on the entry stage lets a person approve before an agent starts. A required approval on your git host covers the merge.
Review usually catches it before merge. After a send-back into code, the next run asks for an Opus-tier agent. A task gets 3 send-backs by default. Then it moves to Blocked with a note, and a person decides what happens next.
Day 1 needs a technical teammate for the one-time device and repo setup. Filing and approving tasks after that needs neither.
Tell us what you're building, and we'll get your first device and repo connected.