kingshand design decisions
These are the records kingshand keeps about how it runs and controls workers: what was decided, what prompted it, what it costs, and what would reverse it. They are mirrored from the repository when this site is built, so they say what the repository says.
The records
- Worker control plane: stay on claude --bg
- This record's own revisit trigger fired. It is kept because the reasoning is still the reason kingshand refused a heavier control plane for as long as it did, and because the trade table below is what the replacement...
- Worker control plane: herdr
- Kingshand spawns and controls workers through herdr. Each worker is an ordinary interactive Claude Code session running in a herdr pane, in a git worktree kingshand creates itself. claude --bg --worktree is gone, and...
Where these come from
- Source: github.com/emgee-labs/kingshand/tree/main/docs
- Mirrored from commit
617dca36, dated 2026-08-30. - Anything not here - the README, the skills, the tests - is in the repository itself.
To install the tool these records describe, see the install page.