Quick start
Binnacle is one local daemon and a set of agent skills. Install it, start it, then set the project up with binn init.
Install
bash
npm i -g @it-bbox/binnacle
binn daemon startbinn daemon start serves the dashboard at http://127.0.0.1:7717 by default; with autostart off, it takes another free port from BINNACLE_PORT. For a one-off run without installing, use npx -p @it-bbox/binnacle binn.
A new project
git init— create the repository.binn init— one plan of everything it sets up, confirmed once./binnacle:roadmap— the vision and the epics./binnacle:product— the first Product session.
Then each epic goes /grill-with-docs → /to-spec → /to-tickets, and each ticket /binnacle:task run <ticket>, in a session of its own. In a harness other than Claude Code, each /binnacle:<action> is binnacle-<action>: see Working from another harness.
An existing project
binn audit— read-only findings; it writes nothing.binn init— the same one plan./binnacle:roadmap— epics proposed from the code, the history and the docs./binnacle:product— the first Product session.
Nothing is moved or rewritten without your yes.