> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/vercel-labs/agent-browser/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<table>
  <thead>
    <tr>
      <th>Parameter</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>url</code></td>
      <td>URL to navigate to. Automatically prepends <code>https\://</code> if no protocol specified.</td>
    </tr>
  </tbody>
</table>

**Options:**

<table>
  <thead>
    <tr>
      <th>Option</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td><code>--headers</code></td>
      <td>JSON object of HTTP headers scoped to the URL's origin</td>
    </tr>
  </tbody>
</table>

**Aliases:** `goto`, `navigate`

**Examples:**

```bash theme={null}
# 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:**

```bash theme={null}
agent-browser back
```

### forward

Go forward in browser history.

**Examples:**

```bash theme={null}
agent-browser forward
```

### reload

Reload the current page.

**Examples:**

```bash theme={null}
agent-browser reload
```

## Workflow Examples

### Basic Navigation Flow

```bash theme={null}
# 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

```bash theme={null}
# 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
```