Page

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

Execute page actions with a simplified command interface. Use:

notte page click "#btn"
notte page click B3         # element ID (auto-detected)
notte page click @B3        # @-prefix also works (legacy)
notte page fill I1 "hello"
notte page goto "https://example.com"

`notte page back`

Go back in browser history

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page captcha-solve <type>`

Solve a CAPTCHA (e.g., recaptcha_v2, hcaptcha)

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page check <id|selector>`

Check or uncheck a checkbox

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)
`--value`	Check (true) or uncheck (false) (default: `true`)

`notte page click <id|selector>`

Click an element

Flag	Description
`--enter`	Press Enter after clicking
`--session-id <string>`	Session ID (uses current session if not specified)
`--timeout <int>`	Timeout in milliseconds

`notte page close-tab`

Close the current tab

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page complete <answer>`

Mark task as complete with an answer

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)
`--success`	Whether the completion was successful (default: `true`)

`notte page download <id|selector>`

Download a file by clicking an element

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page eval-js <code>`

Evaluate JavaScript code on the current page and return the result. The JavaScript code is executed in the context of the page’s main frame. The evaluated value is printed alone on stdout (objects and arrays as JSON, a JS null as “null”), so it pipes straight into jq or a shell variable; the status line goes to stderr. Use -o json for the full execution result. Examples:

notte page eval-js "document.title"
notte page eval-js "window.location.href"
notte page eval-js "document.querySelectorAll('a').length"
notte page eval-js "JSON.stringify([...document.links].map(a => a.href))" | jq length

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page fill <id|selector> [value]`

Fill an input field with a literal value or a credential from the vault attached to the current session. Use --vault-field instead of a value to keep credentials out of the command:

notte page fill "input[name=email]" --vault-field email
notte page fill "input[name=password]" --vault-field password
notte page fill "input[autocomplete=cc-number]" --vault-field card_number

Flag	Description
`--clear`	Clear the field before filling
`--enter`	Press Enter after filling
`--session-id <string>`	Session ID (uses current session if not specified)
`--vault-field <string>`	Fill from the session vault (email, username, password, mfa, card_number, card_holder_name, card_expiration, card_cvv)

`notte page form-fill --data <json>`

Fill a form with JSON data

Flag	Description
`--data <string>`	JSON object with form field values (required)
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page forward`

Go forward in browser history

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page goto <url>`

Navigate to a URL

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page new-tab <url>`

Open a URL in a new tab

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page observe`

Observe the current page state

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page press <key>`

Press a key (e.g., Enter, Escape, Tab)

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page reload`

Reload the current page

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page scrape`

Scrape content from the page

Flag	Description
`--instructions <string>`	Extraction instructions
`--only-main-content`	Only scrape main content
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page screenshot [output]`

Take a screenshot of the current page and save it as a JPEG file. By default, saves to a temporary directory. Optionally provide a path to save to a specific location. Examples:

notte page screenshot                    # saves to tmp directory
notte page screenshot screenshot.jpg     # saves to specified path
notte page screenshot --output out.jpg   # saves to specified path (alt syntax)

Flag	Description
`--path <string>`	Output path for the screenshot (defaults to temp directory)
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page scroll-down [amount]`

Scroll down the page

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page scroll-up [amount]`

Scroll up the page

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page select <id|selector> <value>`

Select a dropdown option

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page switch-tab <index>`

Switch to a tab by index (0-based)

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page upload <id|selector> --file <path>`

Upload a file to an input element

Flag	Description
`--file <string>`	Path to the file to upload (required)
`--session-id <string>`	Session ID (uses current session if not specified)

`notte page wait <milliseconds>`

Wait for a specified duration

Flag	Description
`--session-id <string>`	Session ID (uses current session if not specified)

Getting Started

Commands

`notte page back`

`notte page captcha-solve <type>`

`notte page check <id|selector>`

`notte page click <id|selector>`

`notte page close-tab`

`notte page complete <answer>`

`notte page download <id|selector>`

`notte page eval-js <code>`

`notte page fill <id|selector> [value]`

`notte page form-fill --data <json>`

`notte page forward`

`notte page goto <url>`

`notte page new-tab <url>`

`notte page observe`

`notte page press <key>`

`notte page reload`

`notte page scrape`

`notte page screenshot [output]`

`notte page scroll-down [amount]`

`notte page scroll-up [amount]`

`notte page select <id|selector> <value>`

`notte page switch-tab <index>`

`notte page upload <id|selector> --file <path>`

`notte page wait <milliseconds>`

​notte page back

​notte page captcha-solve <type>

​notte page check <id|selector>

​notte page click <id|selector>

​notte page close-tab

​notte page complete <answer>

​notte page download <id|selector>

​notte page eval-js <code>

​notte page fill <id|selector> [value]

​notte page form-fill --data <json>

​notte page forward

​notte page goto <url>

​notte page new-tab <url>

​notte page observe

​notte page press <key>

​notte page reload

​notte page scrape

​notte page screenshot [output]

​notte page scroll-down [amount]

​notte page scroll-up [amount]

​notte page select <id|selector> <value>

​notte page switch-tab <index>

​notte page upload <id|selector> --file <path>

​notte page wait <milliseconds>

`notte page back`

`notte page captcha-solve <type>`

`notte page check <id|selector>`

`notte page click <id|selector>`

`notte page close-tab`

`notte page complete <answer>`

`notte page download <id|selector>`

`notte page eval-js <code>`

`notte page fill <id|selector> [value]`

`notte page form-fill --data <json>`

`notte page forward`

`notte page goto <url>`

`notte page new-tab <url>`

`notte page observe`

`notte page press <key>`

`notte page reload`

`notte page scrape`

`notte page screenshot [output]`

`notte page scroll-down [amount]`

`notte page scroll-up [amount]`

`notte page select <id|selector> <value>`

`notte page switch-tab <index>`

`notte page upload <id|selector> --file <path>`

`notte page wait <milliseconds>`