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

OpenPlanr in Claude Code

Install OpenPlanr's skills as a Claude Code plugin, invoke them as slash commands, and let Claude see every skill from CLAUDE.md.

In Claude Code, OpenPlanr is a plugin named planr. Its skills run inside your current session.

Install from the marketplace

Run these commands inside Claude Code:

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

Restart Claude Code, then select a skill such as planr:ship, planr:diagram, or planr:operate. The plugin does not require installing the OpenPlanr CLI first.

Install individual skills instead

Run this in a normal terminal from your project:

bash
npx skills add openplanr/OpenPlanr

Choose the skills, Claude Code, and Project or Global scope. Project scope is the default. These skills use names such as planr-ship, rather than the plugin namespace planr:ship, and do not install the plugin's native role definitions. Choose one installation method per host to avoid duplicate discovery.

Invoke a skill

Type a slash followed by planr:ship with the plugin, or select the installed planr-ship skill after an individual installation. Claude Code can also select a skill when your request matches its description.

Command examples elsewhere may use the short or plugin form. Use the installed name in Claude Code's picker if you chose individual skills.

Add the companion CLI when needed

Diagram rendering, local studios, planning validation, diagnostics, and integrations use the companion CLI:

bash
npm install -g openplanr

See Install and set up OpenPlanr for requirements and structured planning setup. Ordinary skills run in your current agent; the optional delegate workflow hands an explicitly requested implementation to another coding agent.

If you prefer CLI-managed installation, openplanr setup guides you through host and scope choices. Its preview shows what it will write before applying changes.

When something goes wrong

  • A skill is missing. Confirm which installation method and scope you used, then restart Claude Code and check its skill picker.
  • Individual skills need an update. Use npx skills update for skills installed through that installer.
  • A CLI-managed installation needs diagnosis. Run openplanr doctor --json. Use openplanr runtime update claude --scope user to update an installation managed by OpenPlanr setup.
  • You want to remove it. Use the installer or plugin manager that installed it. openplanr runtime remove claude removes only an installation managed by OpenPlanr setup.

More fixes are in Troubleshooting, and the host matrix shows what differs between agents.