# --llm-debug

Source: https://zshot-cli.com/reference/flags/diagnostics/llm-debug/
Markdown: https://zshot-cli.com/reference/flags/diagnostics/llm-debug/index.md
Section: [Reference](https://zshot-cli.com/reference/) › [Flags](https://zshot-cli.com/reference/flags/) › [Diagnostics](https://zshot-cli.com/reference/flags/diagnostics/)
CLI: `--llm-debug` · REST: CLI only
Value: `PATH`

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**

```sh
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/
```

## Related

Flags:

- [`--llm-usage`](https://zshot-cli.com/reference/flags/diagnostics/llm-usage/)
- [`--navigator-type`](https://zshot-cli.com/reference/flags/navigator/navigator-type/)
- [`--llm-format-model`](https://zshot-cli.com/reference/flags/document/llm-format-model/)
- [`--navigate`](https://zshot-cli.com/reference/flags/navigator/navigate/)

## Navigation

- [Examples](https://zshot-cli.com/examples/)
- [Download](https://zshot-cli.com/download/)
- [Purchase](https://zshot-cli.com/purchase/)
- [Reference](https://zshot-cli.com/reference/)
  - [Formats](https://zshot-cli.com/reference/formats/)
  - [Flags](https://zshot-cli.com/reference/flags/)
    - [Common](https://zshot-cli.com/reference/flags/common/)
    - [Agents](https://zshot-cli.com/reference/flags/agents/)
    - [Archive](https://zshot-cli.com/reference/flags/archive/)
    - [Browser](https://zshot-cli.com/reference/flags/browser/)
    - [Diagnostics](https://zshot-cli.com/reference/flags/diagnostics/)
      - [--axtree](https://zshot-cli.com/reference/flags/diagnostics/axtree/)
      - [--axtree-only-visible](https://zshot-cli.com/reference/flags/diagnostics/axtree-only-visible/)
      - **--llm-debug**
      - [--llm-usage](https://zshot-cli.com/reference/flags/diagnostics/llm-usage/)
      - [--network-log](https://zshot-cli.com/reference/flags/diagnostics/network-log/)
      - [--pprof-captures-navigation](https://zshot-cli.com/reference/flags/diagnostics/pprof-captures-navigation/)
      - [--pprof-cpu](https://zshot-cli.com/reference/flags/diagnostics/pprof-cpu/)
      - [--pprof-cpu-interval-us](https://zshot-cli.com/reference/flags/diagnostics/pprof-cpu-interval-us/)
      - [--pprof-memory](https://zshot-cli.com/reference/flags/diagnostics/pprof-memory/)
      - [--pprof-memory-interval-bytes](https://zshot-cli.com/reference/flags/diagnostics/pprof-memory-interval-bytes/)
      - [--pprof-no-gzip](https://zshot-cli.com/reference/flags/diagnostics/pprof-no-gzip/)
      - [--trace](https://zshot-cli.com/reference/flags/diagnostics/trace/)
      - [--trace-captures-navigation](https://zshot-cli.com/reference/flags/diagnostics/trace-captures-navigation/)
      - [--trace-no-gzip](https://zshot-cli.com/reference/flags/diagnostics/trace-no-gzip/)
      - [--trace-no-screenshots](https://zshot-cli.com/reference/flags/diagnostics/trace-no-screenshots/)
    - [Document](https://zshot-cli.com/reference/flags/document/)
    - [Image](https://zshot-cli.com/reference/flags/image/)
    - [Navigator](https://zshot-cli.com/reference/flags/navigator/)
    - [Security](https://zshot-cli.com/reference/flags/security/)
    - [Server](https://zshot-cli.com/reference/flags/server/)
    - [Video](https://zshot-cli.com/reference/flags/video/)
  - [Agents](https://zshot-cli.com/reference/agents/)
  - [Configuration](https://zshot-cli.com/reference/configuration/)
  - [Crawling](https://zshot-cli.com/reference/crawling/)
  - [Docker](https://zshot-cli.com/reference/docker/)
  - [Exit Codes](https://zshot-cli.com/reference/exit_codes/)
  - [Linux](https://zshot-cli.com/reference/linux/)
  - [LLM Connections](https://zshot-cli.com/reference/llm_connections/)
  - [LLM Formatting](https://zshot-cli.com/reference/llm_formatting/)
  - [Local Inputs](https://zshot-cli.com/reference/inputs/)
  - [Navigator](https://zshot-cli.com/reference/navigator/)
  - [Security](https://zshot-cli.com/reference/security/)
  - [Server](https://zshot-cli.com/reference/server/)
  - [Shell completions](https://zshot-cli.com/reference/shell_completions/)
  - [Storage](https://zshot-cli.com/reference/storage/)
  - [Timeouts](https://zshot-cli.com/reference/timeouts/)
  - [Web Bot Auth](https://zshot-cli.com/reference/web_bot_auth/)
- [Support](https://zshot-cli.com/support/)
- [Changelog](https://zshot-cli.com/changelog/)

Site index: https://zshot-cli.com/llms.txt