oz0 routine run

Fire a routine now.

For: Operators and developers looking up a command.

Fire a routine now. The fire runs as the routine's service identity, with its tools, outputs and limits; --payload is the trigger's body, which the agent sees as labelled data. With --dry-run the fire's outputs are checked and recorded, and none is applied. Operators may.

Usage

oz0 routine run <name> [flags]

Flags

FlagTypeDefaultDescription
--dry-runboolcheck and record the outputs, apply none
--jsonboolprint JSON instead of a table
--payloadstringthe trigger's body, as JSON
--tenantstringdefaulttenant
--waitboolwait for the fire to end and print its answer and outputs

Inherited flags

FlagTypeDefaultDescription
--contextstring$OZ0_CONTEXT or <config dir>/orchestrator-zero/context.jsonCLI context file written by server init
--log-levelstringinfolog level: debug, info, warn or error

See all oz0 commands and the global flags.

On this page
Copyright © 2026