--llm-debug

CLI: --llm-debug
REST: CLI only

ValuePATH

Appends each call ZShot makes to a model to a text file, for every navigator and the formatter. An entry gives the step, how long the call took, the tokens it spent with any cost the provider reported, the model with its key replaced by ***, the whole prompt, and the reply or the error.

[2026-10-11T11:38:06.576Z] Navigator | action_selection
Duration: 0.765s | Tokens: 1385 prompt (0 cache read, 0 cache write) / 3 completion / 1388 total | $0.00005817 | Vision: no
Config: openrouter://***@?model=typesafe/jev-latest | Questions: 3
────────────────────────────────────────
PROMPT:
…
────────────────────────────────────────
RESPONSE:
…

A decision model’s prompt is the JSON request and its reply the JSON answers. Vision is yes when the call sent a screenshot, and yes (tagged) when the screenshot marked elements with their @eN refs.

Each screenshot sent is written beside the log as PATH.<seq>.<role>.<step>.png, numbered in the order sent. Earlier frames of the page carry .earlier after the step.

The file is appended to, so one log holds several runs. A server writes every request’s calls to it.

Example

CLI Run locally

zshot -f page.png \
  --navigate "Open the first chapter" \
  --navigator-type "anthropic://YOUR_API_KEY@" \
  --llm-debug llm.log \
  https://zshot-cli.com/example_assets/winnie-the-pooh/