Home

stencila workflows run

Run a workflow

Executes a workflow pipeline. Discovers the workflow by name, parses the DOT pipeline, resolves agents, and runs the pipeline through the attractor engine. Currently uses stub backends that log what they would do.

Usage

stencila workflows run [OPTIONS] <NAME>

Examples

# Run a workflow
stencila workflows run code-review

# Run with a goal override
stencila workflows run code-review --goal "Implement login feature"

# Dry run to see pipeline config
stencila workflows run code-review --dry-run

Arguments

NameDescription
<NAME>The name of the workflow to run.

Options

NameDescription
-g, --goalOverride the pipeline goal.
-v, --verboseShow detailed output with prompts and responses. Possible values: true, false.
--dry-runShow workflow config and pipeline without executing. Possible values: true, false.
--auto-approveAuto-approve all human gates immediately. Possible values: true, false.
--auto-approve-afterAuto-approve human gates after a duration.
© 2026 Stencila