---
title: openplanr operate
description: "openplanr operate: Run and resume the durable OpenPlanr Operate lifecycle. Subcommands: domains, validate-note, dashboard, start, get, resume, planning."
url: https://openplanr.dev/docs/cli/operate
updated: 2026-10-06
related:
  - https://openplanr.dev/docs/cli/diagram.md
  - https://openplanr.dev/docs/cli/linear.md
  - https://openplanr.dev/docs/cli/land.md
---

# openplanr operate

Run and resume the durable OpenPlanr Operate lifecycle

```text
openplanr operate [options] [command]
```

## openplanr operate domains

List exact public operating domain identities and registered roles

```text
openplanr operate domains [options]
```

Options:

- `--json`

## openplanr operate validate-note

Inspect one Operate Markdown note against a selected or detected output contract

```text
openplanr operate validate-note [options] <file>
```

Arguments:

- `file` (required): Markdown note to validate

Options:

- `--profile <profile>`: advisor, challenger, chair, or board-report; one of `advisor`, `challenger`, `chair`, `board-report`
- `--contract-version <version>`: note contract version: auto, 1.0.0, or 2.0.0; default `"auto"`; one of `auto`, `1.0.0`, `2.0.0`
- `--json`

## openplanr operate dashboard

The CLI help has no description for this command yet.

```text
openplanr operate dashboard [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--actor <actorId>`: authorized human actor
- `--port <port>`: loopback port; default `"7473"`
- `--no-watch`: disable project-local live updates

## openplanr operate start

The CLI help has no description for this command yet.

```text
openplanr operate start [options]
```

Options:

- `--scope <scopeId>`
- `--domain <domainId>`
- `--domain-version <version>`
- `--focus <focus>`: comma-separated focus values; default `""`
- `--owner <actorId>`: exact human review and Decision owner
- `--route <route>`: contained-execution, planning-work, human-external, or observe-only; default `"observe-only"`; one of `contained-execution`, `planning-work`, `human-external`, `observe-only`
- `--json`

## openplanr operate get

The CLI help has no description for this command yet.

```text
openplanr operate get [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--json`

## openplanr operate resume

The CLI help has no description for this command yet.

```text
openplanr operate resume [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--json`

## openplanr operate planning

Preview and explicitly promote planning-work Actions into SPECs

```text
openplanr operate planning [options] [command]
```

### openplanr operate planning preview

The CLI help has no description for this command yet.

```text
openplanr operate planning preview [options] <actionId>
```

Arguments:

- `actionId` (required)

Options:

- `--actor <actorId>`: exact authorized human Action owner
- `--framing-json <json>`: exact closed Planning framing JSON
- `--framing-file <path>`: read exact Planning framing JSON from path or stdin (-)
- `--json`

### openplanr operate planning create-spec

The CLI help has no description for this command yet.

```text
openplanr operate planning create-spec [options] <proposalId>
```

Arguments:

- `proposalId` (required)

Options:

- `--actor <actorId>`: exact human actor bound by planning preview
- `--confirm <digest>`: exact digest printed by planning preview
- `--json`

## openplanr operate assignment

Prepare, validate, and submit one exact issued Assignment packet

```text
openplanr operate assignment [options] [command]
```

### openplanr operate assignment prepare

The CLI help has no description for this command yet.

```text
openplanr operate assignment prepare [options] <assignmentId>
```

Arguments:

- `assignmentId` (required)

Options:

- `--actor <actorId>`: exact Assignment claimant
- `--runtime <runtime>`: exact claimant runtime
- `--json`

### openplanr operate assignment validate

The CLI help has no description for this command yet.

```text
openplanr operate assignment validate [options] <packetId>
```

Arguments:

- `packetId` (required)

Options:

- `--content-file <path>`: UTF-8 JSON result file, or - for stdin
- `--json`

### openplanr operate assignment submit

The CLI help has no description for this command yet.

```text
openplanr operate assignment submit [options] <packetId>
```

Arguments:

- `packetId` (required)

Options:

- `--content-file <path>`: validated UTF-8 JSON result file, or - for stdin
- `--json`

### openplanr operate assignment recover

The CLI help has no description for this command yet.

```text
openplanr operate assignment recover [options]
```

Options:

- `--older-than-hours <hours>`: clear unsubmitted packets older than this age; default `"24"`
- `--json`

## openplanr operate claim

The CLI help has no description for this command yet.

```text
openplanr operate claim [options] <assignmentId>
```

Arguments:

- `assignmentId` (required)

Options:

- `--actor <actorId>`
- `--runtime <runtime>`: runtime name
- `--json`

## openplanr operate submit

The CLI help has no description for this command yet.

```text
openplanr operate submit [options] <assignmentId>
```

Arguments:

- `assignmentId` (required)

Options:

- `--submission <submissionId>`
- `--actor <actorId>`: exact Assignment claimant
- `--runtime <runtime>`: exact claimant runtime
- `--content-base64 <content>`
- `--media-type <type>`: media type; default `"application/json"`
- `--encoding <encoding>`: utf-8 or binary; default `"utf-8"`
- `--json`

## openplanr operate artifact

The CLI help has no description for this command yet.

```text
openplanr operate artifact [options] <artifactId>
```

Arguments:

- `artifactId` (required)

Options:

- `--actor <actorId>`
- `--actor-kind <kind>`: agent or human
- `--runtime <runtime>`: exact actor runtime
- `--scope <scopeId>`
- `--domain <domainId>`
- `--domain-version <version>`
- `--assignment <assignmentId>`: issued Assignment (required for agents)
- `--representation <representation>`: raw, canonical, metadata, or decoded-json; default `"metadata"`; one of `raw`, `canonical`, `metadata`, `decoded-json`
- `--json`

## openplanr operate review

The CLI help has no description for this command yet.

```text
openplanr operate review [options] <reviewId>
```

Arguments:

- `reviewId` (required)

Options:

- `--actor <actorId>`
- `--cycle <cycleId>`
- `--scope <scopeId>`
- `--domain <domainId>`
- `--domain-version <version>`
- `--json`

## openplanr operate decide

The CLI help has no description for this command yet.

```text
openplanr operate decide [options] <reviewId>
```

Arguments:

- `reviewId` (required)

Options:

- `--actor <actorId>`
- `--cycle <cycleId>`
- `--scope <scopeId>`
- `--domain <domainId>`
- `--domain-version <version>`
- `--choice <choiceId>`: exact choice identity from the latest Review read
- `--choice-hash <digest>`: exact choice digest from the latest Review read
- `--json`

## openplanr operate measurement

Preview and manage disabled-by-default measurement schedules

```text
openplanr operate measurement [options] [command]
```

### openplanr operate measurement preview

The CLI help has no description for this command yet.

```text
openplanr operate measurement preview [options]
```

Options:

- `--request-file <path|->`: exact disabled schedule JSON
- `--actor <actorId>`: exact schedule owner
- `--json`

### openplanr operate measurement enable

The CLI help has no description for this command yet.

```text
openplanr operate measurement enable [options]
```

Options:

- `--request-file <path|->`: closed JSON with schedule and transition
- `--actor <actorId>`: exact schedule owner
- `--confirm <digest>`: exact digest returned by preview
- `--json`

### openplanr operate measurement disable

The CLI help has no description for this command yet.

```text
openplanr operate measurement disable [options] <scheduleId>
```

Arguments:

- `scheduleId` (required)

Options:

- `--request-file <path|->`: exact disable transition JSON
- `--actor <actorId>`: exact schedule owner
- `--confirm <digest>`: current exact schedule digest
- `--json`

### openplanr operate measurement status

The CLI help has no description for this command yet.

```text
openplanr operate measurement status [options] <scheduleId>
```

Arguments:

- `scheduleId` (required)

Options:

- `--actor <actorId>`: exact schedule owner
- `--json`

## openplanr operate experience

The CLI help has no description for this command yet.

```text
openplanr operate experience [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--actor <actorId>`
- `--json`

## openplanr operate today

The CLI help has no description for this command yet.

```text
openplanr operate today [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--actor <actorId>`
- `--json`

## openplanr operate cycles

The CLI help has no description for this command yet.

```text
openplanr operate cycles [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--actor <actorId>`
- `--json`

## openplanr operate evidence

The CLI help has no description for this command yet.

```text
openplanr operate evidence [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--actor <actorId>`
- `--json`

## openplanr operate outcomes

The CLI help has no description for this command yet.

```text
openplanr operate outcomes [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--actor <actorId>`
- `--json`

## openplanr operate history

The CLI help has no description for this command yet.

```text
openplanr operate history [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--actor <actorId>`
- `--json`

## openplanr operate cycle

The CLI help has no description for this command yet.

```text
openplanr operate cycle [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--actor <actorId>`
- `--json`

## openplanr operate outcome

The CLI help has no description for this command yet.

```text
openplanr operate outcome [options] <cycleId> <outcomeId>
```

Arguments:

- `cycleId` (required)
- `outcomeId` (required)

Options:

- `--actor <actorId>`
- `--json`

## openplanr operate search

The CLI help has no description for this command yet.

```text
openplanr operate search [options] <cycleId> <query>
```

Arguments:

- `cycleId` (required)
- `query` (required)

Options:

- `--actor <actorId>`
- `--json`

## openplanr operate export

The CLI help has no description for this command yet.

```text
openplanr operate export [options] <cycleId>
```

Arguments:

- `cycleId` (required)

Options:

- `--actor <actorId>`
- `--format <format>`: json or html; default `"json"`
- `--json`

## openplanr operate recovery

Inspect or restore durable state

```text
openplanr operate recovery [options] [command]
```

### openplanr operate recovery storage-status

Inspect neutral or legacy Operate storage without activating it

```text
openplanr operate recovery storage-status [options]
```

Options:

- `--json`

### openplanr operate recovery migrate-storage

Replay-verify legacy v2 storage and activate its exact state with rollback custody

```text
openplanr operate recovery migrate-storage [options]
```

Options:

- `--json`

### openplanr operate recovery rollback-storage

Restore the verified pre-migration v2 Store and preserve forward state

```text
openplanr operate recovery rollback-storage [options]
```

Options:

- `--json`

### openplanr operate recovery inspect

The CLI help has no description for this command yet.

```text
openplanr operate recovery inspect [options]
```

Options:

- `--json`

### openplanr operate recovery restore

The CLI help has no description for this command yet.

```text
openplanr operate recovery restore [options] <generation>
```

Arguments:

- `generation` (required)

Options:

- `--json`

### openplanr operate recovery clear-stale-lock

The CLI help has no description for this command yet.

```text
openplanr operate recovery clear-stale-lock [options]
```

Options:

- `--json`