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

# roark simulation plan list

> List run plans

Returns a paginated list of simulation run plans. Optionally filter by search text or agent ID.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation plan list [options]
```

> [!NOTE]
>
> Calls `GET /v1/simulation/plan`

## Options

**--limit** `integer`

Maximum number of run plans to return (default: 20, max: 50).

**--after** `string`

Cursor for pagination - use the nextCursor value from a previous response.

**--search-text** `string`

Search text to filter run plans by name.

**--agent-id** `string`

Filter run plans by agent ID.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark simulation plan list
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.