Write a performance trace sidecar alongside another output, the way --har captures a HAR. Takes a path:

zshot --output-type png --trace page.trace.json https://zshot-cli.com -f page.png

The trace is gzip-compressed by default; name the path .trace.json or pass --trace-no-gzip for a plain file. To emit a trace as the primary output instead of a sidecar, use --output-type trace.

This is a Pro-tier flag.

On the HTTP server, request this as with_trace=true instead of a path. The server writes the trace to a temporary location and returns its URL in a Link response header. See the API reference for reading those links and --server-additional-asset-expiration for how long they live.