◆ Pi FlowDocs

CLI reference

The piflowctl run command and its flags: provider, thinking, sandbox, and DAG scoping.

draft — this page is a stub

Draft — this page is the canonical public home for CLI flags. Keep it generated from / verified against the CLI source in packages/cli; do not let it drift from the implementation.

piflowctl run <templateDir>

Run a workflow template on the pi fleet.

piflowctl run .piflow/<workflow>/template --provider <gateway> --thinking low --sandbox local
Flag Meaning
--provider <gateway> the provider/gateway the fleet calls
--thinking <level> reasoning effort (e.g. low)
--sandbox <mode> sandbox mode (e.g. local)
--dry-run validate the template and wiring without spending tokens
--from <node> start the run at this node
--until <node> stop the run after this node