run_ ID.
Run scope flags
The run scope flags narrow a command to the runs that a set of records shaped.oqoqo runs list, oqoqo frictions list, and oqoqo frictions get take all of them. oqoqo experiments list takes all of them except --experiment-id, and lists the experiments of those runs. oqoqo results analyze takes them too, but its --experiment-id, --task-id, and --friction-id are its own analysis flags.
Each flag takes one ID, and a run counts only when it matches every flag you pass.
- An ID with the wrong prefix is a usage error. The message says where the right ID comes from.
- An ID that the project doesn’t have fails with
scope_not_foundinstead of returning an empty list. The error names each ID it couldn’t find. - The runs and frictions results return
scope: each record they counted, with itskind,id, currentname, anddashboardUrl.
oqoqo runs list
Page every run of the current project, newest first, with stable IDs, outcomes, and errors.list_runs
Flags
The first twelve flags are the run scope flags. Also takes the global flags.
Examples
List the failed runs of one experiment:
runId and trialId, the task, the treatment, and the agent with its model and effort, plus these fields. The result also has scope, hasMore, and nextCursor.
Notes
Continue with
--cursor while hasMore is true. To fix a setup failure, see A run could not start because a setup command failed.
oqoqo runs profile
Show where one run’s tool calls, time, and tokens went, and which skills, MCP servers, CLIs, and SDKs from its treatment the agent used.get_run_profile
Arguments
Takes only the global flags.
Examples
setupFailure, with the fields listed under oqoqo runs list. The text output names the step and what to fix, prints the oqoqo resources inspect command for the machine or tool that declared it, then shows the command and its output.
oqoqo runs trajectory
Read one page of a run’s ordered steps, with token usage and measured tool durations.get_run_trajectory
Arguments
Flags
Also takes the global flags.
Examples
Read the first 500 steps, then the next page:
Notes
For a summary of the whole run, use
oqoqo runs profile.
oqoqo runs transcript
Read one byte-bounded page of a run’s original transcript, unchanged.get_run_transcript
Arguments
Flags
Also takes the global flags.
Examples
Read the first page, then the next:
Notes
Use
--output json to receive the exact bytes. It’s the same file that ⋯ → Download trajectory saves on run details.
oqoqo runs output
Read what a run left behind: the file manifest, a diff of one file or the whole run, one file, the agent’s final message, or the full archive.get_run_output
Arguments
Flags
Also takes the global flags.
Examples
List the files a run changed, then read one file’s diff:
Notes
Use
--output json to receive the exact bytes. The dashboard shows the same files on the Output tab of run details.
oqoqo results analyze
Run one structured analysis over the runs in a scope: summarize, compare treatments, find failures and frictions, or read one run’s evidence.analyze_results
Arguments
Flags
--schedule-id through --agent-model-id are run scope flags. Also takes the global flags.
Modes
compare_treatments compares mean costs only within one cost source, so it never mixes costs that the agent reported with costs that Oqoqo estimated.
Examples
Summarize one experiment:
--output json, the analysis is in data.result. The baseline is the treatment that the experiment’s plan names as referenceTreatmentClientId. If none is marked, compare_treatments uses the first treatment.
Notes
A pass rate is
passedRuns / (passedRuns + failedRuns), which is 1 - failureRate. Runs that are blocked, inconclusive, or whose Evals failed have no verdict, so they stay out of both counts. Wait until pendingRuns is 0, because the counts can still change until then.
--limit is an upper bound, and the response size limit can return fewer items. The rows that page.completeData names can be finer than the ranked items, so check the hint before you compare counts. For how results become final, see What Evals read and What Insights read.
Related
oqoqo frictions
List frictions with the same run scope flags.
oqoqo evals and insights
Start Evals and Insights and page their results.
Read results
Matrix, Runs, and Compare in the dashboard.
CLI reference
Global flags, output, and exit codes.

