oz0 workspace edit

Edit a YAML file of your draft (or of the head) as the studio's forms do, and print the result; --write puts it into your draft.

For: Operators and developers looking up a command.

Edit a YAML file of your draft (or of the head) as the studio's forms do, and print the result; --write puts it into your draft. --set path=value takes the value as YAML (5, true, "text", [a, b], {k: v}), and paths look like model.primary, steps[1].when or tools[2] (an index equal to the length appends).

Usage

oz0 workspace edit <folder> <path> [flags]

Flags

FlagTypeDefaultDescription
--setstringArraypath=value; repeatable
--tenantstringdefaultthe tenant
--unsetstringArraya path to remove; repeatable
--writeboolwrite the result into your draft

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