> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pome.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# pome tasks

> Browse and copy the bundled task library per digital twin.

`pome tasks` lists the curated task catalog that ships with the CLI. Use it to
discover the runnable tasks for each digital twin and copy them into your project for editing.

The catalog is the source of truth for `pome tasks`.
Per-digital-twin task descriptions live on each [digital twin reference page](/docs/twins/github).

<Note>
  `pome scenarios` was renamed to `pome tasks`. The old name still runs as a
  hidden, deprecated alias and prints a one-line pointer; update your scripts to
  `pome tasks`, as the alias will be removed in a future release.
</Note>

## Usage

```bash theme={null}
pome tasks [twin] [options]
```

## Arguments

| Argument | Required | Description                                                                                                |
| -------- | -------- | ---------------------------------------------------------------------------------------------------------- |
| `[twin]` | No       | Digital twin id (`github`, `stripe`, `slack`, `gmail`, or `linear`). Omit to list available digital twins. |

## Options

| Flag           | Default    | Description                                                     |
| -------------- | ---------- | --------------------------------------------------------------- |
| `--copy`       | off        | Copy the digital twin's runnable tasks into the local project.  |
| `--dest <dir>` | `./tasks/` | With `--copy`, write into this directory instead of `./tasks/`. |
| `--force`      | off        | With `--copy`, overwrite existing files in the destination.     |

## Behavior

* **No args** — prints available digital twins and one-line descriptions.
* **`<twin>`** — lists runnable tasks for that digital twin. Reference-only seed files
  (e.g. `00-default-seed.md`) are skipped.
* **`--copy`** — writes the same runnable files into `./tasks/` (or `--dest`).
  Existing files are preserved unless `--force` is set.

## Examples

```bash theme={null}
# List twins
pome tasks

# List GitHub tasks
pome tasks github

# Copy Stripe tasks into the project
pome tasks stripe --copy

# Copy into a custom directory, overwriting existing files
pome tasks slack --copy --dest ./my-tasks --force
```

## Related

After copying, run a task with [`pome run`](./run):

```bash theme={null}
pome run tasks/01-bug-happy-path.md --agent "<your agent command>"
```