openplanr 3.0.0
Major Changes
openplanrversions return to plain SemVer from 3.0.0: patch releases for fixes, minor releases for features and major releases for breaking changes. Releases 2.2639.0 to 2.2641.x were numbered<major>.<YYWW>.<n>by release week. Version checks such asopenplanr upgradecompare versions numerically, so 3.0.0 is newer than every 2.x release.Drop Node.js 20, which reached end of life in April 2026. This is a breaking CLI change:
openplanrnow requires Node.js^22.13.0 || >=23.5.0, and the pipeline and Protocol require Node.js 22.13.0 or later.Run
node -vto check your version. If it reports v20, or a 22 release below 22.13, install Node.js 24 LTS or Node.js 22.13 or later, then rerun the installer ornpm install --global openplanr.On Node.js 20 the install scripts stop before installing anything with
E_NODE_VERSION: OpenPlanr requires Node.js ^22.13.0 || >=23.5.0; found v20.x.y.npm install --global openplanronly warns about the engines range, andopenplanrthen stops before loading anything withE_NODE_VERSION: OpenPlanr requires Node.js ^22.13.0 || >=23.5.0; found 20.x.y.openplanr-pipeline doctorfails its Node.js check withNode 20.x.y does not satisfy engines.node >=22.13.0, and the delegate skill's probe reports that Node 22 or later is required.Remove the
planrandplanr-pipelinecommands. They were kept for one release after the rename toopenplanr; this is a breaking change for anything that still runs them.Replace
planr <command>withopenplanr <command>or the short aliasopr <command>, andplanr-pipeline <command>withopenplanr-pipeline <command>, in scripts, shell aliases and CI. Upgrading withopenplanr upgrade apply, the installer ornpm install --global openplanrremoves the oldplanrandplanr-pipelinelinks. Then runopenplanr doctor: if it reports installed skills or rules that still runplanr, rerunopenplanr setupfor the hosts it names, or update the plugin, and restart the agent. Theplanrnpm package is a different product; don't install it to restore the old command.Skill names such as
/planr:plan, theplanrplugin, theplanr-pipelinenpm package and the.planr/folder are unchanged.
Patch Changes
Keep Studio view controls centered in their workspace and actions usable on narrow screens and with enlarged text. Shared dialogs, drawers and menus preserve keyboard focus, while changing views retains prototype state, camera position and annotation drafts.
The plan skill now ends with the host's ship command,
/ship T-NNNin Claude Code,$ship T-NNNin Codex or theplanr-shiprule in Cursor, instead of/planr-shipand$planr-ship. The pipeline's plan procedures point to/planr:planinstead of the retiredopenplanr spec decomposecommand.The Claude plugin's documentation link points to the OpenPlanr docs at https://openplanr.dev/docs instead of the getting-started guide on GitHub.
After a CLI upgrade,
openplanr upgrade statusreportsagents-behindinstead ofincompatiblewhen only your coding agents need updating, and lists the commands to run. When a file in an installed runtime package was edited,openplanr runtime updateandopenplanr setupname the file and stop, andopenplanr doctor --fixrestores the package from the CLI after you confirm, backing up the changed files first;upgrade statuspoints there instead of at a step that would fail. Error messages keep relative paths such asskills/delegate/scripts/context.mjsintact.