---
title: OpenPlanr
description: OpenPlanr is the open harness around your coding agent. Install the plugin or skills, with a companion CLI for rendering, validation and local tools.
url: https://openplanr.dev/
updated: 2026-11-19
related: []
---

# Close the loop from intent to delivery.

The open harness around your coding agent: plans as files in your repo, checks before you merge, and a record of what shipped. Claude Code, Codex and Cursor. MIT.

To set it up from a coding agent, fetch https://openplanr.dev/setup.md and follow its steps.

## 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.

- **Specify** (`/spec`): shape a request into a clear, measurable specification grounded in the current repository.
- **Plan** (`/planr:plan`): write user stories and tasks under the specification, with acceptance criteria and file-level change lists.
- **Ship** (`/ship`): implement one task in the repository, verify it, and record it in the provenance log.
- **Validate and sync** (`openplanr sync`, `openplanr status`): the deterministic CLI validates what the agent wrote, renders it, and keeps GitHub Issues or Linear in step.

## 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: `spec`, `plan`, `plan-review`, `sprint`.
- Implement: `ship`, with frontend, backend, database, QA, DevOps and documentation roles.
- Review and QA: `browser-qa` against real routes, forms, viewports, accessibility, console and network behavior.
- Design: `design`, `design-loop`, `design-review` in a shared canvas, prototype and walkthrough studio.
- Diagrams: `openplanr diagram render` creates, verifies or rerenders offline diagrams.
- Artifact reviews: `artifact` moves feedback between a local HTML artifact and its review board.
- Land and release: `land`, `release`.
- Setup and diagnostics: `openplanr doctor` and `investigate`.
- Status, routing and sync: `openplanr status`, `openplanr sync`.
- Operate: `openplanr operate` runs an operating review across seven executive lenses.

The full catalog: https://openplanr.dev/docs/skills

## Works with the agents you already use

Install the Claude Code plugin from its marketplace:

```text
/plugin marketplace add openplanr/marketplace
/plugin install planr@openplanr
```

Or run this in a normal terminal from your project to choose individual skills, destination hosts, and Project or Global scope:

```bash
npx skills add openplanr/OpenPlanr
```

Project scope is the default. The installer can place skills in other supported hosts too; installation availability does not establish that every workflow has been verified in every host. Choose one installation method per host.

Plugin names use `planr:ship`; source skills use `planr-ship`. Add the companion CLI for workflows that need diagram rendering, local studios, planning validation, diagnostics, or integrations. `openplanr setup` remains an option for CLI-managed plugins and rules.

## One repository. Three npm packages.

One canonical skill graph is generated into host-native projections for Claude Code, Codex and Cursor.

- `openplanr`: the CLI. Stores and validates planning files, renders diagrams and reports, installs the skills into each host, diagnoses installations, and syncs with GitHub Issues and Linear. Install with `npm install -g openplanr`.
- `planr-pipeline`: the delivery pipeline, an exact optional dependency of `openplanr`, installed by `openplanr setup`.
- `@openplanr/protocol`: MIT-licensed JSON schemas, canonical registries and browser-safe schema validation.

## Continue exploring OpenPlanr

- Blueprint: https://openplanr.dev/blueprint.md
- Docs: https://openplanr.dev/docs/llms.txt

## 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.

Start with the marketplace plugin or `npx skills add openplanr/OpenPlanr`. Follow the getting started guide for installation choices and the companion CLI: https://openplanr.dev/docs/get-started/install.md

Source code: https://github.com/openplanr/OpenPlanr
