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

# openplanr story

Manage story artifacts deterministically

```text
openplanr story [options] [command]
```

## openplanr story create

Create a story from flags or a JSON object

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

Arguments:

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

Options:

- `--title <title>`: story 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
- `--feature <id>`: parent feature ID; may also come from --data

## openplanr story list

List story artifacts

```text
openplanr story list [options]
```

## openplanr story show

Print one story artifact

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

Arguments:

- `id` (required)

## openplanr story update

Update story frontmatter fields

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

Arguments:

- `id` (required)

Options:

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