oz0 tenant works-council

Works-council mode is on for every tenant until one of its admins turns it off.

For: Operators and developers looking up a command.

Works-council mode is on for every tenant until one of its admins turns it off. While it is on, usage and cost figures summed over people (quota usage, the web UI's Cost and Budgets pages, and every API that sums per person) show a person's own figures only to that person, a team's only when it has at least the threshold's people (five, or more if you raise it with --threshold), and otherwise only the tenant's totals.

Quotas per person are still enforced. Records are not hidden: the audit trail, budget requests with who asked and who decided, and who started a job. --off turns the mode off and needs --reason, which the audit log keeps (tenant.works_council.off); --on turns it on again; lowering the threshold also needs --reason. Without flags it shows the mode.

Usage

oz0 tenant works-council <tenant> [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
--offboolturn the mode off: figures about every person and team are shown (needs --reason; audited)
--onboolturn the mode on again
--reasonstringwhy, for the audit log (at most 500 characters)
--thresholdintthe smallest team whose figures are shown, 5 or more

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