# Navigator

Source: https://zshot-cli.com/reference/flags/navigator/
Markdown: https://zshot-cli.com/reference/flags/navigator/index.md
Section: [Reference](https://zshot-cli.com/reference/) › [Flags](https://zshot-cli.com/reference/flags/)

## Flags

| Flag | Description |
| --- | --- |
| [`--navigate`](https://zshot-cli.com/reference/flags/navigator/navigate/) | Navigator behavior. The navigator is an agent that can accomplish tasks. (Pro) |
| [`--navigator-allow-url`](https://zshot-cli.com/reference/flags/navigator/navigator-allow-url/) | Additional URLs the navigator may visit (Pro) |
| [`--navigator-captures-playwright`](https://zshot-cli.com/reference/flags/navigator/navigator-captures-playwright/) | Write the navigator's actions as a Playwright script that replays them (Pro) |
| [`--navigator-captures-puppeteer`](https://zshot-cli.com/reference/flags/navigator/navigator-captures-puppeteer/) | Write the navigator's actions as a Puppeteer script that replays them (Pro) |
| [`--navigator-captures-video`](https://zshot-cli.com/reference/flags/navigator/navigator-captures-video/) | Capture navigator actions as a video (Pro) |
| [`--navigator-credential`](https://zshot-cli.com/reference/flags/navigator/navigator-credential/) | Credential to make available to navigator (Pro) |
| [`--navigator-credential-env`](https://zshot-cli.com/reference/flags/navigator/navigator-credential-env/) | Credential whose value is read from an environment variable at startup (Pro) |
| [`--navigator-credential-helper`](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper/) | Credential resolved on demand by a helper instead of given as a value (Pro) |
| [`--navigator-credential-helper-env`](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper-env/) | Environment variable passed through to executable credential helpers (Pro) |
| [`--navigator-credential-helper-timeout`](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper-timeout/) | Time limit for one credential helper call (Pro) |
| [`--navigator-credential-origin`](https://zshot-cli.com/reference/flags/navigator/navigator-credential-origin/) | URL glob where a credential may be typed (Pro) |
| [`--navigator-credential-secret`](https://zshot-cli.com/reference/flags/navigator/navigator-credential-secret/) | Shared secret for credential helpers (Pro) |
| [`--navigator-data`](https://zshot-cli.com/reference/flags/navigator/navigator-data/) | A value the navigator sees and fills by name (Pro) |
| [`--navigator-data-json`](https://zshot-cli.com/reference/flags/navigator/navigator-data-json/) | A JSON object of navigator data, inline or at a URL (Pro) |
| [`--navigator-escalation-max`](https://zshot-cli.com/reference/flags/navigator/navigator-escalation-max/) | The most actions a navigator escalated to takes on a page before control returns (Pro) |
| [`--navigator-file`](https://zshot-cli.com/reference/flags/navigator/navigator-file/) | File to make available to navigator for file inputs (Pro) |
| [`--navigator-file-size-limit`](https://zshot-cli.com/reference/flags/navigator/navigator-file-size-limit/) | Size limit for a navigator file (Pro) |
| [`--navigator-file-timeout`](https://zshot-cli.com/reference/flags/navigator/navigator-file-timeout/) | Time limit for fetching one URL-backed navigator file (Pro) |
| [`--navigator-goal`](https://zshot-cli.com/reference/flags/navigator/navigator-goal/) | Navigator goal. LLM navigators can support open ended goals that they interpret (Pro) |
| [`--navigator-initial-scope`](https://zshot-cli.com/reference/flags/navigator/navigator-initial-scope/) | Where the navigator may go before --navigator-allow-url widens it (Pro) |
| [`--navigator-max-steps`](https://zshot-cli.com/reference/flags/navigator/navigator-max-steps/) | How many steps a navigator is allowed to use to complete its goal (Pro) |
| [`--navigator-stall-escalation`](https://zshot-cli.com/reference/flags/navigator/navigator-stall-escalation/) | Steps a navigator may take on one page before it is judged stalled (Pro) |
| [`--navigator-step-timeout`](https://zshot-cli.com/reference/flags/navigator/navigator-step-timeout/) | Seconds a navigator's model has for each reply, and the page for each action (Pro) |
| [`--navigator-type`](https://zshot-cli.com/reference/flags/navigator/navigator-type/) | The navigators that drive --navigate (Pro) |
| [`--navigator-video-captions-position`](https://zshot-cli.com/reference/flags/navigator/navigator-video-captions-position/) | Where captions are drawn in the navigator video (Pro) |
| [`--navigator-video-height`](https://zshot-cli.com/reference/flags/navigator/navigator-video-height/) | Height of navigator video (Pro) |
| [`--navigator-video-shows-captions`](https://zshot-cli.com/reference/flags/navigator/navigator-video-shows-captions/) | Caption the actions the navigator explains, each held to be read (Pro) |
| [`--navigator-video-shows-pointer`](https://zshot-cli.com/reference/flags/navigator/navigator-video-shows-pointer/) | Draw the pointer: an arrow, or a fingertip on a touch device (Pro) |
| [`--navigator-video-width`](https://zshot-cli.com/reference/flags/navigator/navigator-video-width/) | Width of navigator video (Pro) |

## 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/)
    - [Document](https://zshot-cli.com/reference/flags/document/)
    - [Image](https://zshot-cli.com/reference/flags/image/)
    - **Navigator**
      - [--navigate](https://zshot-cli.com/reference/flags/navigator/navigate/)
      - [--navigator-allow-url](https://zshot-cli.com/reference/flags/navigator/navigator-allow-url/)
      - [--navigator-captures-playwright](https://zshot-cli.com/reference/flags/navigator/navigator-captures-playwright/)
      - [--navigator-captures-puppeteer](https://zshot-cli.com/reference/flags/navigator/navigator-captures-puppeteer/)
      - [--navigator-captures-video](https://zshot-cli.com/reference/flags/navigator/navigator-captures-video/)
      - [--navigator-credential](https://zshot-cli.com/reference/flags/navigator/navigator-credential/)
      - [--navigator-credential-env](https://zshot-cli.com/reference/flags/navigator/navigator-credential-env/)
      - [--navigator-credential-helper](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper/)
      - [--navigator-credential-helper-env](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper-env/)
      - [--navigator-credential-helper-timeout](https://zshot-cli.com/reference/flags/navigator/navigator-credential-helper-timeout/)
      - [--navigator-credential-origin](https://zshot-cli.com/reference/flags/navigator/navigator-credential-origin/)
      - [--navigator-credential-secret](https://zshot-cli.com/reference/flags/navigator/navigator-credential-secret/)
      - [--navigator-data](https://zshot-cli.com/reference/flags/navigator/navigator-data/)
      - [--navigator-data-json](https://zshot-cli.com/reference/flags/navigator/navigator-data-json/)
      - [--navigator-escalation-max](https://zshot-cli.com/reference/flags/navigator/navigator-escalation-max/)
      - [--navigator-file](https://zshot-cli.com/reference/flags/navigator/navigator-file/)
      - [--navigator-file-size-limit](https://zshot-cli.com/reference/flags/navigator/navigator-file-size-limit/)
      - [--navigator-file-timeout](https://zshot-cli.com/reference/flags/navigator/navigator-file-timeout/)
      - [--navigator-goal](https://zshot-cli.com/reference/flags/navigator/navigator-goal/)
      - [--navigator-initial-scope](https://zshot-cli.com/reference/flags/navigator/navigator-initial-scope/)
      - [--navigator-max-steps](https://zshot-cli.com/reference/flags/navigator/navigator-max-steps/)
      - [--navigator-stall-escalation](https://zshot-cli.com/reference/flags/navigator/navigator-stall-escalation/)
      - [--navigator-step-timeout](https://zshot-cli.com/reference/flags/navigator/navigator-step-timeout/)
      - [--navigator-type](https://zshot-cli.com/reference/flags/navigator/navigator-type/)
      - [--navigator-video-captions-position](https://zshot-cli.com/reference/flags/navigator/navigator-video-captions-position/)
      - [--navigator-video-height](https://zshot-cli.com/reference/flags/navigator/navigator-video-height/)
      - [--navigator-video-shows-captions](https://zshot-cli.com/reference/flags/navigator/navigator-video-shows-captions/)
      - [--navigator-video-shows-pointer](https://zshot-cli.com/reference/flags/navigator/navigator-video-shows-pointer/)
      - [--navigator-video-width](https://zshot-cli.com/reference/flags/navigator/navigator-video-width/)
    - [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