oz0 memory settings set

Change how long plugins' records last and how much one scope holds, and which purposes read each other's records.

For: Operators and developers looking up a command.

Change how long plugins' records last and how much one scope holds, and which purposes read each other's records. Every flag left out keeps its value. --compatible from>to lets jobs for purpose to read records written for purpose from (repeat for more; it replaces the list, and --no-compatible clears it); reading never grants writing. A job without a purpose reads only records written without one.

A later default or longest end, a higher cap and a new pair loosen: with four eyes on they wait for another admin. A change applies to writes from then on; records already written keep their ends (a later version that carries its record's end past a lowered longest end is brought down to it). Closed and ended records count toward the caps until retention removes them.

Usage

oz0 memory settings set [flags]

Flags

FlagTypeDefaultDescription
--compatiblestringArraya pair of purposes from>to: jobs for to read records written for from (repeat for more)
--decision-refstringthe decision or case the change follows, such as a case number (at most 200 characters)
--default-daysint32the end a record gets when its writer gives none, in days (0 for the default, 90)
--jsonboolprint JSON instead of a table
--max-bytesintthe most bytes of the newest versions of the records one plugin keeps in one scope (0 for the default, 8 MiB; at most 64 MiB)
--max-daysint32the latest end a writer may give, in days (0 for the default, 365; at most 3650)
--max-recordsint32the most records one plugin keeps in one scope, closed and ended ones too (0 for the default, 5000; at most 20000)
--no-compatibleboolmap no purposes as compatible
--reasonstringwhy, required for every governance change (at most 500 characters; default $OZ0_REASON); the audit log keeps it

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
--tenantstringdefaultthe tenant

See all oz0 commands and the global flags.

On this page
Copyright © 2026