---
title: openplanr upgrade
description: "openplanr upgrade: Reconcile the installed OpenPlanr tuple against the published compatible set. Subcommands: status, apply."
url: https://openplanr.dev/docs/cli/upgrade
updated: 2026-10-06
related:
  - https://openplanr.dev/docs/cli/sync.md
  - https://openplanr.dev/docs/cli/template.md
  - https://openplanr.dev/docs/cli/update.md
---

# openplanr upgrade

Reconcile the installed OpenPlanr tuple against the published compatible set

```text
openplanr upgrade [options] [command]
```

## openplanr upgrade status

Report whether the installed tuple is aligned, upgradable, or incompatible

```text
openplanr upgrade status [options]
```

Options:

- `--json`: machine-readable output; default `false`

## openplanr upgrade apply

Upgrade the OpenPlanr CLI and list the command that updates each coding agent

```text
openplanr upgrade apply [options]
```

Options:

- `--yes`: proceed with the upgrade without an interactive confirmation; default `false`
- `--notes <mode>`: what's new: highlights or full; default `"highlights"`
- `--json`: machine-readable output; default `false`