> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser Automation

> The browser tool — navigate, interact with, and extract content from web pages.

## Overview

The `browser` tool provides web browsing capabilities to your agent. It can navigate to URLs, interact with page elements, extract content, and take screenshots. This is powered by a headless browser (Playwright) running on the host system.

## Capabilities

| Action       | Description                        |
| ------------ | ---------------------------------- |
| `navigate`   | Open a URL in the browser          |
| `click`      | Click on an element                |
| `type`       | Type text into an input field      |
| `extract`    | Extract text content from the page |
| `screenshot` | Take a screenshot of the page      |
| `scroll`     | Scroll the page                    |
| `wait`       | Wait for an element or condition   |

## Usage Examples

### Navigating and Extracting

The agent can browse a website and extract relevant information:

```json theme={null}
{
  "tool": "browser",
  "input": {
    "action": "navigate",
    "url": "https://news.ycombinator.com"
  }
}
```

Followed by:

```json theme={null}
{
  "tool": "browser",
  "input": {
    "action": "extract",
    "selector": ".titleline"
  }
}
```

### Form Interaction

```json theme={null}
{
  "tool": "browser",
  "input": {
    "action": "type",
    "selector": "#search-input",
    "text": "ArgentOS documentation"
  }
}
```

## Configuration

```json theme={null}
{
  "agents": {
    "defaults": {
      "browser": {
        "headless": true,
        "timeout": 30000,
        "viewport": { "width": 1280, "height": 720 }
      }
    }
  }
}
```

## Prerequisites

The browser tool requires Playwright to be installed:

```bash theme={null}
npx playwright install chromium
```

## Security Considerations

<Warning>
  The browser runs with the same permissions as the ArgentOS process. Be cautious with agents that have both browser and exec tools -- they can be powerful in combination.
</Warning>

* Consider restricting allowed domains in production environments
* Cookie and session data persists between browser actions within a session

## Limitations

<Note>
  * Browser state does not persist across gateway restarts
  * JavaScript-heavy SPAs may require explicit wait conditions
  * File downloads through the browser require separate handling
  * The browser runs headless by default; there is no visual UI to observe
</Note>