oz0 tenant max-effort

Set the most reasoning effort the tenant's agents' models run at: low, medium, high, xhigh, max, or none to remove the ceiling.

For: Operators and developers looking up a command.

Set the most reasoning effort the tenant's agents' models run at: low, medium, high, xhigh, max, or none to remove the ceiling. A job that asks for more, or whose model's own default is above it, runs at the ceiling from its next start, and its trace says so (effort_adjusted).

The gateway lowers any call that asks for more to the ceiling at once, also a job's that is already running and a session's that sets its own effort, and names the change in the answer's Oz0-Effort-Lowered header. Raising or removing the ceiling loosens a cost control: it takes a reason and, where the tenant has four eyes on, another admin's approval.

Usage

oz0 tenant max-effort <tenant> <level | none> [flags]

Flags

FlagTypeDefaultDescription
--decision-refstringthe decision or case the change follows, such as a case number (at most 200 characters)
--jsonboolprint JSON instead of a table
--reasonstringwhy, required for every governance change (at most 500 characters; default $OZ0_REASON); the audit log keeps it

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