Skip to content
OpenPlanr Docs
GitHub (opens in a new tab)

Tip · 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.

When a skill misbehaves, run openplanr doctor --json before you change anything. It checks the installation, the agent adapters, and the project, and lists every managed installation with what is unhealthy.

openplanr doctor --fix previews repairs to the files OpenPlanr owns, then asks once before applying them. It keeps each agent's saved scope and Codex discovery choice, uses the plugin bundled with the running CLI, and does not upgrade the CLI or change credentials. A healthy second run makes no changes.

In your agent, /planr:doctor runs the same diagnosis and previews every repair. Installing packages, changing versions, and deleting files always wait for your confirmation.

OpenPlanr Docs
Commands for
Theme