Open source · Claude Code, Codex, Cursor

Close the loop from intent to delivery.

Your agent writes the code. OpenPlanr is the open harness around it.Plans as files in your repo, checks before you merge, and a record of what shipped.

Plan. Ship and verify. Operate.

Install the Claude Code plugin → Or choose individual skills below.

npx skills add openplanr/OpenPlanr

Plan: a typed /spec command becomes SPEC-001, which splits into user stories and tasks saved as files under .planr/ in the repo.

// How it works

Plans are files.
The agent reads them first.

Specifications, user stories, tasks, and provenance live under .planr/ in your repository, reviewed and versioned like code. Plan and ship stay separate steps that you invoke.

  1. Specify
    Shape a request into a clear, measurable specification grounded in the current repository.
    /spec
  2. Plan
    Write user stories and tasks under the specification, with acceptance criteria and file-level change lists.
    /planr:plan
  3. Ship
    Implement one task in the repository, verify it, and record it in the provenance log.
    /ship
  4. Validate and sync
    The deterministic OpenPlanr CLI validates what the agent wrote, renders it, and keeps GitHub Issues or Linear in step.
    openplanr sync · openplanr status
// Capabilities

Plan. Ship and verify.
Operate.

Every step is a skill the agent selects from its description, or that you invoke by name. The open toolkit needs no account.

  • Plan and specify
    Shape intent into a measurable specification, decompose it into stories and tasks, review the plan, and refine the backlog into a sprint.
    spec · plan · plan-review · sprint
  • Implement
    Implement a plan, specification, or task end to end in the current repository, with frontend, backend, database, QA, DevOps, and documentation roles.
    ship
  • Review and QA
    Run browser-backed QA against real routes, forms, viewports, accessibility, console, and network behavior.
    browser-qa
  • Design
    Design an interface in a shared canvas, prototype, and walkthrough studio, compare three directions, and review with stable board pins.
    design · design-loop · design-review
  • Diagrams
    Create, inspect, verify, or rerender offline diagrams across 39 grammars, from architecture and sequence to ER, Gantt, and Wardley.
    $openplanr diagram render
  • Artifact reviews
    Open, share, import, or export an HTML artifact review, so feedback moves between a local artifact and its review board.
    artifact
  • Land and release
    Assess release readiness before merge, then choose a versioning scheme, classify shipped changes, and write release notes.
    land · release
  • Setup and diagnostics
    Diagnose CLI, pipeline, and installation health, and investigate a bug to its root cause with an optional bounded fix.
    $openplanr doctor
  • Status, routing, and sync
    See what is done, pending, or blocked, audit planning files for drift, open the local dashboard, and route a request to the best skill.
    $openplanr status · openplanr sync
  • Operate
    Run an operating review across seven executive lenses (CEO, CTO, CPO, CMO, COO, challenger, and chair) and produce a decision and action brief.
    $openplanr operate

Browse all 25+ skills in the catalog →

// Hosts

Works with the agents
you already use

Install the plugin or skills in the coding agent you already use. Add the companion CLI when a workflow needs it.

Claude Code
/planr:<skill>
Install the planr plugin from the OpenPlanr marketplace. Or choose individual skills with the skills installer.
>/plugin marketplace add openplanr/marketplace /plugin install planr@openplanr
Codex
$planr-<skill>
Choose individual skills in the installer. The companion CLI can also manage the unified planr plugin.
$npx skills add openplanr/OpenPlanr
Cursor
planr-<skill>
Install individual skills and select them in Cursor. CLI-managed project rules remain an alternative.
$npx skills add openplanr/OpenPlanr
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.

Companion CLIv3.8.0

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.65.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.19.0

@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

Continue exploring OpenPlanr

Built with itself.

The diagrams in OpenPlanr's README are rendered by openplanr diagram render from canonical documents and verified in CI by openplanr diagram check.

Give your AI agent
the full picture.

Open source. MIT licensed.

$ npx skills add openplanr/OpenPlanr

Choose skills and destinations in your terminal. Requires Node.js 22.20+. For the plugin, see the getting started guide.

Reply in the beta thread with one feature you'd plan first.

Join the beta (opens GitHub in a new tab)
TypeScriptNode.jsCommander.jsHandlebarsZodBiome