oz0 job search

Search the job summaries management keeps, newest first, so jobs Temporal has forgotten are found too.

For: Operators and developers looking up a command.

Search the job summaries management keeps, newest first, so jobs Temporal has forgotten are found too. QUERY holds words that must each be in a job's ID, agent, error or tags, and filters written as key:value: agent:, status:, tag:, node:, version:, group: (an error group from job errors), finding:, conversation:, is:top or is:child. For example: job search agent:triage status:failed timeout.

Usage

oz0 job search [QUERY] [flags]

Flags

FlagTypeDefaultDescription
--agentstringonly this agent's or flow's jobs, by name or <plugin>/<agent>
--allboolread every page, not one
--jsonboolprint JSON instead of a table
--limitint32at most this many rows a page (the server's 25 when 0, at most 100)
--page-tokenstringgo on after the page before: the token it printed
--sinceduration168h0m0sjobs that started this long ago at most
--statusstringonly jobs with this status: running, completed, failed, canceled, timed_out or terminated
--tagstringsonly jobs with this tag; repeat for several, which must all be there
--tenantstringdefaulttenant
--untildurationjobs that started at least this long ago

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