Global Flags

Flags available on all Zonai CLI commands.

These flags are accepted by all Zonai commands.

Flags#

Flag	Short	Description
`--help`	`-h`	Print usage information for the current command
`--config <path>`	`-c`	Path to `zonai.yaml`; auto-detected if omitted
`--flavor <name>`	—	Config flavor to load (affects `serve`, `compile`, `build`)
`--release`	—	Production mode: disable asserts, disable file watchers in `serve`
`--quiet`	`-q`	Suppress all non-error output
`--loud`	`-L`	Maximum verbosity — print all internal debug logs
`--log <level>`	—	Set log level: `trace` , `debug` , `info` , `warn` , `error`

--config Auto-Detection#

If --config is not provided, Zonai searches the current directory and its parents for zonai.yaml or zonai.yml. The first file found is used. This allows running commands from any subdirectory of the project.

--flavor and --release#

These flags are independent:

--flavor selects which config file is compiled into workers
--release controls compilation flags (no asserts) and serve behavior (no watchers)

You can combine them freely:

zonai serve --flavor dev --release   # release build of dev config
zonai build --flavor prod --release  # production build