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

# modus workflows run

> Trigger a workflow run now (ad-hoc), streaming its events. Use --thread to continue an existing run session.

Trigger a workflow run now (ad-hoc), streaming its events. Use --thread to continue an existing run session.

## Usage

```bash theme={null}
modus workflows run [flags]
```

## Arguments

| Name      |          | Description                                                                    |
| --------- | -------- | ------------------------------------------------------------------------------ |
| `id`      | required | Workflow id.                                                                   |
| `message` | optional | Message/input for the run (quote it). Optional — not every workflow needs one. |

## Flags

| Flag        | Type    | Description                                                      |
| ----------- | ------- | ---------------------------------------------------------------- |
| `--thread`  | string  | Continue an existing run session id.                             |
| `--version` | string  | Saved version to run.                                            |
| `--json`    | boolean | Emit structured SSE-derived events instead of raw streamed text. |

Global: `--pretty` — human-readable table output instead of compact JSON.

## Examples

```bash theme={null}
modus workflows run 42 "Run the weekly digest now"
modus workflows run 42
```

See [CLI quickstart](/guides/cli) for install and auth.