---
title: openplanr backlog
description: "openplanr backlog: Manage backlog artifacts deterministically. Subcommands: add, list, show, update."
url: https://openplanr.dev/docs/cli/backlog
updated: 2026-10-06
related:
  - https://openplanr.dev/docs/cli/operate.md
  - https://openplanr.dev/docs/cli/land.md
  - https://openplanr.dev/docs/cli/epic.md
---

# openplanr backlog

Manage backlog artifacts deterministically

```text
openplanr backlog [options] [command]
```

## openplanr backlog add

Create a backlog from flags or a JSON object

```text
openplanr backlog add [options] [title...]
```

Arguments:

- `title...` (optional): backlog title or description

Options:

- `--title <title>`: backlog title
- `--data <path>`: read deterministic JSON fields from a file, or - for stdin
- `--file <path>`: deprecated alias for --data
- `--json`: emit one machine-readable result
- `-p, --priority <priority>`: critical, high, medium, or low
- `-t, --tag <tags...>`
- `--epic <id>`

## openplanr backlog list

List backlog artifacts

```text
openplanr backlog list [options]
```

## openplanr backlog show

Print one backlog artifact

```text
openplanr backlog show [options] <id>
```

Arguments:

- `id` (required)

## openplanr backlog update

Update backlog frontmatter fields

```text
openplanr backlog update [options] <id>
```

Arguments:

- `id` (required)

Options:

- `--status <status>`
- `--owner <owner>`
- `--title <title>`