Navigation Commands

Navigate between pages and control browser history

Overview

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

Commands

open

Navigate to a URL.

Parameter	Description
url	URL to navigate to. Automatically prepends https:// if no protocol specified.

Options:

Option	Description
—headers	JSON 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