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

# simforge runs

> Reference for simforge runs: usage, arguments and flags, generated from the CLI.

Generated from the CLI's own help (CLI 0.2.0-rc.5). Global flags and exit codes are on the [command reference](/cli).

## runs cancel

Cancel a hosted run; artifacts it already produced are kept

```sh theme={null}
simforge runs cancel [OPTIONS] <ID>
```

| Argument / flag | Notes | What |
| - | - | - |
| `<id>` | required | The id |

## runs list

List your workspace's hosted runs, newest first, one summary row each

```sh theme={null}
simforge runs list [OPTIONS]
```

| Argument / flag | Notes | What |
| - | - | - |
| `--limit LIMIT` | default 20 | At most this many items on the page |
| `--cursor CURSOR` | | The next page: the `nextCursor` of the page before it |
| `--status STATUS` | one of queued, running, succeeded, partial, failed, cancelled, active | Only runs in this status; `active` is queued or running |
| `--type TYPE` | | Only runs of this type (`render`, `closed_loop`, `scenario_from_log`, ...) |
| `--mine` | | Only runs you submitted: none of your teammates' and none published from other workspaces |
| `--full` | | Full run objects (input, jobs, billing, result) instead of one summary row per run; `runs show ID` reads one |

## runs show

One hosted run: status, cost, jobs and artifacts

```sh theme={null}
simforge runs show [OPTIONS] <ID>
```

| Argument / flag | Notes | What |
| - | - | - |
| `<id>` | required | The id |

## runs watch

Follow a hosted run until it succeeds, fails, is partial or is cancelled

```sh theme={null}
simforge runs watch [OPTIONS] <ID>
```

| Argument / flag | Notes | What |
| - | - | - |
| `<id>` | required | The id |


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