---
title: openplanr setup
description: "openplanr setup: Set up OpenPlanr skills for your coding agents. Usage and options including --runtime, --scope, --skill-mode."
url: https://openplanr.dev/docs/cli/setup
updated: 2026-10-06
related:
  - https://openplanr.dev/docs/cli/init.md
  - https://openplanr.dev/docs/cli/server.md
  - https://openplanr.dev/docs/cli/doctor.md
---

# openplanr setup

Set up OpenPlanr skills for your coding agents

```text
openplanr setup [options]
```

Options:

- `--runtime <runtime>`: auto, claude, codex, cursor, or all
- `--scope <scope>`: user, project, or both
- `--skill-mode <mode>`: Codex skill delivery: direct, unified-plugin, or project-rule
- `--replace-managed`: replace only manifest-owned OpenPlanr discovery content when switching modes; default `false`
- `--minimal`: skip agent integrations; keep using the installed CLI; default `false`
- `--version <version>`: pin the pipeline and adapter version
- `--dry-run`: preview exact changes without writing; default `false`
- `--yes`: apply without an interactive confirmation; default `false`
- `--json`: emit machine-readable output; default `false`