--warc

Write a WARC web archive alongside another output. Takes a path:

zshot --output-type png --warc page.warc.gz https://zshot-cli.com -f page.png

The archive is gzip-compressed by default; pass --warc-no-gzip for plain WARC. To emit a WARC as the primary output on its own, use --output-type warc.

A WARC records every credential seen on the wire — session cookies, bearer tokens, and OAuth tokens the visited site issues, not only headers you pass — because it is built to replay the capture faithfully. There is no redaction option. Treat the archive as sensitive as the session itself. On the server it is auth-gated behind the same credentials as the render endpoint and expires per --server-additional-asset-expiration.

This is a Standard-tier flag.

On the HTTP server, request this as with_warc=true instead of a path. The server writes the WARC 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.