25+ skills3 hosts3 npm packages

How OpenPlanr
closes the loop.

OpenPlanr is not a hosted project tracker and does not replace your issue tracker. It closes the loop: the agent reads the plan before it changes code, and what it ships flows back as evidence for the next review.

  • openplanr v2.2641.2
  • planr-pipeline v0.57.0
  • @openplanr/protocol v0.10.3
MIT licensed · Claude Code, Codex, and Cursor · Node.js 20.19+, 22.13+, or 23.5+ · openplanr.dev
Packages

One repository. Three npm packages.

One canonical skill graph is generated into host-native projections for Claude Code, Codex, and Cursor. Generated files are outputs, never sources.

CLI and host packagesv2.2641.2

openplanr

binary: openplanr

Stores and validates planning files, renders diagrams and reports, installs the skills into each host, diagnoses installations, and syncs with GitHub Issues and Linear.

openplanr setupopenplanr initopenplanr diagramopenplanr doctor
Runs as · Terminalnpm install -g openplanr
Delivery pipelinev0.57.0

planr-pipeline

exact optional dependency of openplanr

The delivery pipeline: PO, design, review, implementation, QA, and delivery outputs, plus self-contained projections of the Protocol, Operate runtime, artifact review, and design contracts.

ProtocolOperate runtimeartifact review
Runs as · Skillsinstalled by openplanr setup
Schemas and registriesv0.10.3

@openplanr/protocol

MIT-licensed contracts

Public contracts for OpenPlanr local tools and hosted consumers: JSON schemas, canonical registries, and browser-safe schema validation.

schemas/registries/schema validation
Runs as · Integrationsnpm i @openplanr/protocol
Claude Code plugin · role agents

Nine role agents. Two skills. One human gate.

Each role agent's manifest lists the only tools it may use. planr-database can run psql, mysql, sqlite3, and mongosh but not git; planr-designer reads, finds, and writes files, with no shell at all.

PlanDecompose
/planr:plan
planr-database
Read-only schema introspection · PostgreSQL, MySQL, MSSQL, SQLite, MongoDB
planr-designer
PNG mockups → 10-section design-spec.md · colors, typography, components, layout
planr-specification
Specification → user stories and tasks · writes planning artifacts only
Human gate
You review the plan, then invoke ship. The agent never chains plan and ship on its own.
ShipImplement
/ship
planr-frontend ‖ planr-backend
Independent work in parallel · frontend never touches services or DB, backend never touches UI
planr-qa
Reviews the change without editing it · acceptance, security, correctness
planr-devops · planr-documentation
Docker, CI, and env config, never deploys · documentation, never application code
Tool lists · declared in each agent manifestWithout native agents, the same lenses run in the active agentplanr-entity-scaffold · ORM entities from the scanned schema
Quick start

From an empty terminal to one shipped task.

The getting started guide in six steps. Plans land under .planr/ in your repository, and you invoke plan and ship as separate steps.

1

Install the CLI

You · terminal

OpenPlanr requires Node.js 20.19+, 22.13+, or 23.5+. The package installs the openplanr command and its short form opr.

~
$ npm install -g openplanr $ openplanr --version
produces:openplanropr
2

Install the skills

You · terminal

openplanr setup shows exactly what it will write, then installs the skills for the host and scope you choose. Existing files are backed up under ~/.planr/backups/.

~
$ openplanr setup --runtime claude --scope user --dry-run $ openplanr setup --runtime claude --scope user
produces:OpenPlanr plugin
3

Initialize the project

You · terminal

openplanr init creates .planr/config.json and the artifact directories. Commit .planr/ with your code.

~/your-project
$ cd your-project $ openplanr init
produces:.planr/config.json.planr/stories/.planr/tasks/
4

Write the first specification

Coding agent · spec

Restart the coding agent so it loads the skills. The spec skill reads the repository, asks only the questions that change the outcome, and writes the specification.

Claude Code
> /spec "Add passwordless sign-in for existing accounts"
produces:.planr/specs/SPEC-001-<slug>/
5

Plan and review the plan

Coding agent · plan, plan-review

Plan writes user stories and tasks under the specification, with acceptance criteria and file-level change lists. Plan review adds product, engineering, design, and developer-experience findings.

Claude Code
> /planr:plan > /plan-review
produces:US-NNN storiesT-NNN tasks
6

Ship one task

Coding agent · ship

Ship implements one task in the repository, verifies it, and records it in the provenance log. Plan and ship are separate steps; the agent never chains them on its own.

Claude Code
> /ship
produces:code and tests.planr/provenance.jsonl