oz0 workspace explain

Usage and flags for oz0 workspace explain.

For: Operators and developers looking up a command.

Writes four files into --out: diagram.svg (the plugin's graph, laid out as the studio draws it, legible printed in black and white), diagram.mmd (the same graph as a Mermaid flowchart), summary.html (one printable page: what the plugin and each flow do, the steps, approvals, the tool-policy rules that apply with their IDs, data rules, purposes and legal bases, recipients, budgets, the coverage figure when the files hold a coverage report, the version and digests) and explain.json (the same facts as data).

Print the page to PDF from a browser. The same files and settings give the same bytes, so two exports diff cleanly. The tenant's tool policy and data rules are included when you hold governance.read, its purposes, legal bases and recipients when you hold inventory.read; the page says what was left out. Each export is audited. The page describes what the files and settings state; it is not an assessment. Of the head, a revision (--revision) or your draft (--draft).

Usage

oz0 workspace explain <folder> --out <dir> [flags]

Flags

FlagTypeDefaultDescription
--draftboolyour draft, when you have one
--flowstringkeep one flow, its steps and what they run
--outstringthe folder to write diagram.svg, diagram.mmd, summary.html and explain.json into
--revisionstringthe heada revision, or its first 7 or more characters
--tenantstringdefaultthe tenant

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