--navigator-file

File to make available to navigator for file inputs.

Example

zshot --navigator-type "anthropic" \
  --navigator-file "resume=./resume.pdf" \
  --navigate "Attach my resume and submit the application" https://example.com/apply

Details

Format: “name=/path/to/file” or “name=data:<mime>;base64,…”

Example: “resume=./resume.pdf”

Repeat the flag to provide several files. The navigator attaches a file to an <input type="file"> by name, either on its own or while filling a form; the model sees only the name, never the path or the file’s contents. When the name matches a field’s label the file is attached directly, otherwise the model infers which file belongs in which field.

Over the server and MCP, navigator_file takes a name-to-data-URL map on the JSON body, and values must be base64 data URLs — the server never reads local files. A data URL is capped at 10 MB, and the uploaded file is named after its key plus an extension derived from the MIME type.