Documentation
Install Devplane, start a change against a spec, and make “done” mean your own gate passed against the tree as it stands.
Devplane tells you when an agent’s work is actually done. Run any ACP agent in its own worktree, verify its change with your own checks run outside the agent, see the weakened tests first, and keep the record of who decided what while you were not looking. One binary, local-first.
Start with the quickstart, then take the workbench tour. When something looks wrong, Troubleshooting goes from symptom to command.
Getting started
Install it, and get the board on screen.
Install Install Devplane on your platform — installer, npm, cargo or the window — check it works, upgrade it, and remove every trace of it. Quickstart From nothing to a verified change, step by step: install, start the host, make a practice repository with a failing test, let an agent fix it, and read how it was verified. The workbench A tour of Devplane's interface: the regions, a change's six views, the review, the palette and the keys that matter. Troubleshooting What a symptom means and the command that fixes it: the gate is off, the port is taken, a session is not watched, GitHub is not read, a verified change went stale, the ledger is empty after an upgrade.
Guides
The loop, end to end.
Watching sessions How Devplane sees agent sessions it did not start: the roster, command hooks, OpenTelemetry and the optional status line — per vendor, and what each state means. Driving agents Start, prompt, watch, stop and resume any agent that speaks the Agent Client Protocol — and add one that is not built in with one entry in a file. Verified done A change is an isolated checkout, an agent in it, and your own gate as the definition of done. Verified means that gate passed against the tree exactly as it stands. Working to a specification Name the spec folder a change answers, send an agent the tasks you choose, and make your own gates the verdict inside Spec Kit's workflow. The decision log Why a command ran without anybody being asked, and why there is a pull request on this branch — answerable months later, with the authority and the rule or check named. Reports between projects A finding one project's agent makes about another reaches that project's person — quoted, with an origin the host checked — and the answer travels back to the change that raised it.
Reference
Every flag, key and rule.
CLI reference Every Devplane command and flag. Reading works with nothing running; a command that needs the host says so. Configuration The complete devplane.toml reference. Every key is read by the code; an unknown key is a parse error rather than a silent default. Permissions Devplane never approves a tool call. It refuses one (never_auto) or puts one in front of you (always_ask), in Claude Code's rule syntax, per repository — and fails closed when the rules will not load. Architecture One binary and one store: the hook writes, the host folds, the pure core may not reach the outside world. The API route table, recovery, shutdown and the window. Security The trust model: what stays on your machine, what guards the local API, where the permission gate fails closed, and what Devplane does not defend against.