Skip to main content

​
Overview

Navigation commands allow you to control page navigation, browser history, and page reloads.

​
Commands

​
open

Navigate to a URL.
ParameterDescription
urlURL to navigate to. Automatically prepends https:// if no protocol specified.
Options:
OptionDescription
—headersJSON object of HTTP headers scoped to the URL’s origin
Aliases: goto, navigate Examples: 
# Navigate to a URL
agent-browser open example.com

# Navigate with explicit protocol
agent-browser open https://example.com

# Navigate with custom headers
agent-browser open api.example.com --headers '{"Authorization": "Bearer token"}'

# Navigate to local file
agent-browser open file:///path/to/file.html
Supported protocols:
  • http://, https:// - Web pages
  • file:// - Local files
  • about: - Browser internal pages
  • data: - Data URIs
  • chrome://, chrome-extension:// - Chrome-specific

​
back

Go back in browser history. Examples: 
agent-browser back

​
forward

Go forward in browser history. Examples: 
agent-browser forward

​
reload

Reload the current page. Examples: 
agent-browser reload

​
Workflow Examples

​
Basic Navigation Flow

# Open a page
agent-browser open example.com

# Navigate to another page
agent-browser open example.com/about

# Go back
agent-browser back

# Go forward
agent-browser forward

# Refresh the page
agent-browser reload

​
Authenticated Navigation

# Navigate with auth headers (scoped to origin)
agent-browser open api.example.com --headers '{"Authorization": "Bearer <token>"}'

# Headers are automatically included in subsequent requests to the same origin
agent-browser click @e1

# Navigate to different domain - headers are NOT sent
agent-browser open other-site.com

Build docs developers (and LLMs) love

Get started for freeTalk to us