---
description: Reference for executing one workflow invocation from the command line.
---

# flue run

Last updated May 30, 2026 [ View as Markdown](https://flueframework.com/docs/cli/run/index.md) 

## Synopsis

```
flue run <workflow> [--target node] [--payload <json>] [--root <path>] [--output <path>] [--config <path>] [--env <path>]
```

## Description

`flue run` builds the selected Node project and executes one discovered workflow locally. It uses private child-process communication, so the workflow does not need public HTTP or WebSocket exposure and application ingress middleware is not executed.

A workflow invocation is a finite run with a run ID. Use `flue connect` for interactive agent-instance sessions.

## Arguments

| Argument   | Description                     |
| ---------- | ------------------------------- |
| <workflow> | Workflow module name to invoke. |

## Options

| Option            | Default                                                    | Description                                                                                                                      |
| ----------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| \--payload <json> | {}                                                         | Supply the workflow payload as JSON.                                                                                             |
| \--target node    | Configuration value                                        | Select the supported local execution target.                                                                                     |
| \--root <path>    | Selected config-file directory, or config search directory | Select the project root.                                                                                                         |
| \--output <path>  | <root>/dist                                                | Select the build output directory.                                                                                               |
| \--config <path>  | Auto-discovered flue.config.\*                             | Select a configuration file.                                                                                                     |
| \--env <path>     | <config-base>/.env, when present                           | Select one alternate .env\-format file loaded before configuration. Relative paths resolve from <config-base>. Shell values win. |

## Output and events

Build diagnostics are written to stdout before execution. Run identity and streamed events are written to stderr. A successful non-null terminal workflow result is written as formatted JSON to stdout.

## Target support

`flue run` supports Node builds only. To exercise a Cloudflare-target workflow locally, start `flue dev --target cloudflare` and call its public ingress surface.

## Examples

```
flue run hello --target node
flue run summarize --target node --payload '{"text":"hello"}' --env .env.staging
```

See [Workflows](https://flueframework.com/docs/guide/workflows/) for authoring and invoking workflows.

## Docs Navigation

Current page: [flue run](https://flueframework.com/docs/cli/run/)

### Sections

* [Guide](https://flueframework.com/docs/getting-started/quickstart/)
* [Reference](https://flueframework.com/docs/api/agent-api/)
* [CLI](https://flueframework.com/docs/cli/overview/)
* [SDK](https://flueframework.com/docs/sdk/overview/)
* [Ecosystem](https://flueframework.com/docs/ecosystem/overview/)

### CLI

* [ Overview ](https://flueframework.com/docs/cli/overview/)
* [ init ](https://flueframework.com/docs/cli/init/)
* [ dev ](https://flueframework.com/docs/cli/dev/)
* [ connect ](https://flueframework.com/docs/cli/connect/)
* [ run ](https://flueframework.com/docs/cli/run/)
* [ build ](https://flueframework.com/docs/cli/build/)
* [ logs ](https://flueframework.com/docs/cli/logs/)
* [ add ](https://flueframework.com/docs/cli/add/)