planr
A small planning layer for agent-built products, using Markdown files in Git.
When several coding agents work on one product, planr shows what is ready, blocked, waiting on you & what changed. Tasks & their dependencies live in a planning repository, usually separate from your code & often private. No database, daemon or MCP server.
planr says what is next. Your project's orchestrator, such as split-orchestrator, handles the build.
Get started
Paste this prompt into your coding agent. It checks Node.js & Git, asks where to keep the plan & sets up the planning files & plugin.
Set up planr for this project. Follow https://planr.so/docs/setup.md
To set it up yourself, follow the quickstart. planr needs Node.js 20 or newer & Git. The CLI has no runtime dependencies.
Plugins & CLI
- Claude Code. Call the skill with
/planr:planr. - Codex. Call the skill with
$planr:planr. - bb. See the board beside your threads & approve or check work.
- Other agents. Install the skill with
npx skills add instructa/planr. - CLI. Check files, find ready work & update status. Install it with
npm install -g planror usenpx planr.
More detail
- Concepts for how the plan, tasks, goals & approvers fit together.
- The board for progress & history.
- File format & technical contract.
License
MIT. Bundled fonts use the SIL Open Font License 1.1. See the font licenses.