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

# openplanr task

Manage task artifacts deterministically

```text
openplanr task [options] [command]
```

## openplanr task create

Create a task from flags or a JSON object

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

Arguments:

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

Options:

- `--title <title>`: task 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
- `--story <id>`
- `--feature <id>`

## openplanr task list

List task artifacts

```text
openplanr task list [options]
```

## openplanr task show

Print one task artifact

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

Arguments:

- `id` (required)

## openplanr task update

Update task frontmatter fields

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

Arguments:

- `id` (required)

Options:

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