oz0 policy explain

Usage and flags for oz0 policy explain.

For: Operators and developers looking up a command.

Say what one rule of the tenant's tool policy does with today's catalog: the functions its pattern and kinds name, which of them it decides (for every caller, or for the calls its condition or callers name), the earlier rules that decide some of them first, the later rules it hides, and what still raises a decision of its functions: the taint-default rule, floors, origin and sequence rules, and a plugin's own requires_approval.

A condition is decided call by call, so the command names it rather than evaluating it.

With --command, it decides a shell command as a harness's shell call would be decided by the tenant's command rules and the platform's defaults, here, with the same reader the nodes run: each part the command runs (every program after its wrappers), the defaults' checks that found something in it, the tenant's rules that match it, what decided it, and the verdict for the whole command (the strictest part, then the floor that asks about what cannot be read).

--agent, --caller and --cwd say whose job runs it and where. Nothing runs, and nothing is saved.

Usage

oz0 policy explain <id> | --command <command> [flags]

Flags

FlagTypeDefaultDescription
--agentstringwith --command: the agent whose job runs it, for the rules narrowed to agents
--callerstringArraywith --command: the calling plugin as rules by caller name it: plugin:<name>, publisher:<namespace>, source:<kind>
--commandstringa shell command to decide as a harness's shell call would be: its parse, every rule that matched each part, and the one that decided
--cwdstringwith --command: the session's working directory, an absolute path (unknown when empty)
--jsonboolprint JSON instead of a table
--tenantstringdefaulttenant
--toolstringclaude-agent-sdk.Bashwith --command: the harness's shell tool, <harness>.<tool>

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