AutoMax
ReferenceCLI commands

automax trace

Open Playwright traces of a run, or a trace zip, in the trace viewer.

automax trace [zip] [--last] [--run <id>] [--artifacts-dir <dir>] [--list] [--json]
Argument / flagMeaning
zipa trace.zip file, or a directory to search recursively
--lastthe most recent run under the artifacts directory (default when nothing else is given)
--run <id>a specific run id
--artifacts-dirwhere runs live (default .automax/runs, or AUTOMAX_ARTIFACTS_DIR)
--listprint the trace files instead of opening them (--json prints { source, traces })

Traces are recorded on the first retry and for failures (trace: on-first-retry), so a fully green run has none.

automax trace --last
automax trace --run 0193f0c2-… --list
automax trace .automax/runs/<id>/pw-output/demo-shop--ui--chromium/login/trace.zip

Exit code 2 when no run or no trace file is found.