Quick start

From zero to a committed, reviewable worktree in five commands.

1. Create a task bean

beans create "Add input validation" -t task \
  -d "Validate all inputs at trust boundaries."
# → hordr-0001

2. Hand it to an agent

hordr run hordr-0001
# → started hordr-0001 in hordr-0001 (role: implementer, pane: wX:pNEW)

The agent gets an isolated git worktree on branch hordr-0001, a pane, and the bean body as its brief. It works, commits, and stops.

3. Watch / review

The agent runs in its own pane — switch to it in herdr, or just leave it. When it marks the bean completed and runs /done, hordr checks the result.

4. Finish

hordr finish hordr-0001
# → finished hordr-0001: merged hordr-0001 into develop, removed worktree …, deleted branch hordr-0001

finish asserts the bean is completed, merges its branch into your primary branch, removes the worktree, and safe-deletes the branch (-d, never -D). Single-bean mode →

That’s it

One bean, one worktree, one agent, one merged commit. For a whole milestone in parallel, see Fleet mode.