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

# openplanr epic

Manage epic artifacts deterministically

```text
openplanr epic [options] [command]
```

## openplanr epic create

Create a epic from flags or a JSON object

```text
openplanr epic create [options] [title...]
```

Arguments:

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

Options:

- `--title <title>`: epic 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

## openplanr epic list

List epic artifacts

```text
openplanr epic list [options]
```

## openplanr epic show

Print one epic artifact

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

Arguments:

- `id` (required)

## openplanr epic update

Update epic frontmatter fields

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

Arguments:

- `id` (required)

Options:

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