oz0 replay privilege propose

Usage and flags for oz0 replay privilege propose.

For: Operators and developers looking up a command.

Adds the suggested rules to the tenant's tool policy in shadow mode, with the preset origin privilege, through the same reviewed path as every tool-policy change: it takes --reason (or $OZ0_REASON), the audit trail keeps it, and a shadow rule records what it would have decided without deciding anything. A rule the policy has already (the same function, agent and origin) is not added twice.

Promote a rule when its shadow record and its replay say so; a change that turns a shadow rule on shows its newest replay.

Usage

oz0 replay privilege propose ID [--agent A,...] --reason TEXT [flags]

Flags

FlagTypeDefaultDescription
--agentstringsonly the rules for these agents
--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
--tenantstringdefaulttenant

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