Skip to main content
Version: v5.6.1

opschain runs logs

Included from Basic tier

opschain runs logs <run-id> [flags]

The same command as opschain logs, registered inside the run family so it is found where runs are inspected — see opschain docs cli/logs for the full manual. In short: it reads a run's persisted logs (paging through everything without --limit), streams live ones with --follow, or writes them to a file with --download. A workflow-run id plays back the logs of every run its workflow steps spawned, interleaved and labelled with the nested step's path under its workflow step.

Flags​

FlagMeaning
--step <path>Only this step path and its descendants. No leading or trailing /.
--followStream new log lines until interrupted. Mutually exclusive with --download.
--download <file>Write the log lines to this file instead of stdout.
--cursor <cursor>Resume strictly after this keyset cursor (from a previous page's stderr hint or -o json output).
--limit <n>Read a single page of at most this many lines (0 = page through everything).

See also​

  • opschain docs cli/logs — the full manual: modes, output shapes, exit codes and named errors.
  • opschain docs cli/runs-show — the run's step tree the log paths come from.