Tips
Short tips for getting more out of OpenPlanr in Claude Code, Codex and Cursor.
Commit the planning folder with your code
Keep specs, stories, and tasks in the same commits as the code they describe, so every session and teammate reads the same plan.
Plan
Add the companion CLI when a workflow needs it
Start with the plugin or skills, then add the companion CLI for rendering, local studios, planning validation, and diagnostics.
Build
Let your agent see every skill
Generate the OpenPlanr capabilities guidance so your agent knows every skill and when to reach for it.
Understand
Name the files a task must not touch
Put protected files on a task's Preserve list, and Ship leaves them unchanged while it builds the task.
Plan · Build
Skills add no model calls or telemetry
Every skill runs inside the coding agent you already use, and the CLI never calls a model.
Understand
Plan and ship are separate steps
Your agent never chains planning into building on its own, so you can review the plan before any code changes.
Plan · Build
Restart your agent after setup
Your coding agent loads its skills when it starts, so restart it after setup or a plugin update before you look for a skill.
Debug
Start with doctor when a skill misbehaves
The doctor command shows every managed installation and what is unhealthy, and previews repairs before it changes anything.
Debug
Ask for status as often as you like
Status reads the plan and changes nothing, so it is safe to run before every standup or handoff.
/planr:status$status@planr-statusThese examples use CLI-managed direct skills. With the plugin, use
$planr:status; with individual source skills, use$planr-status.These examples use CLI-managed Cursor rules. With individual source skills, select
planr-statusin the skill picker.Understand
You can undo setup
Roll back to the state before setup, or remove one agent's OpenPlanr files, without losing files you changed.
Debug