flue run

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 for authoring and invoking workflows.