---
title: agent-browser
description: Add browser automation tools backed by agent-browser to an eve agent.
type: extension
keywords:
  - browser
  - browser automation
  - web automation
  - cli
  - chrome
  - playwright
  - puppeteer
  - kernel
  - browserbase
  - browser use
---

# agent-browser

Extension integration for eve. Add browser automation tools backed by agent-browser to an eve agent.

## Install

Install the agent-browser extension for eve:

```bash
eve add extension/agent-browser
```

The extension installs agent-browser automatically on first use and runs it inside the agent's sandbox. It requires a sandbox backend with real process execution, such as Vercel Sandbox, Docker, or microsandbox.

## Quick start

Mount the extension under `agent/extensions/`:

```ts title="agent/extensions/browser.ts"
import browser from "@agent-browser/eve";

export default browser({});
```

The filename supplies the `browser` namespace. The extension adds tools such as `browser__navigate`, `browser__snapshot`, `browser__click`, `browser__fill`, `browser__find`, and `browser__screenshot`. agent-browser keeps the underlying browser process and session state in the eve sandbox.

## Configure

Restrict browser access to the sites the agent needs with the extension's domain allow-list:

```ts title="agent/extensions/browser.ts"
import browser from "@agent-browser/eve";

export default browser({
  allowedDomains: ["example.com", "*.example.com"],
  contentBoundaries: true,
  maxOutputChars: 50_000,
});
```

Also configure the [sandbox network policy](/docs/sandbox#network-policy) for defense in depth. Treat saved browser state, cookies, screenshots, downloads, and recordings as sensitive data. Do not place passwords or session tokens in prompts. Use the extension's per-tool overrides to gate or disable actions your agent should not take unattended.

The extension also supports inline screenshots, session naming, proxies, and production pre-installation. See the [agent-browser eve extension documentation](https://github.com/vercel-labs/agent-browser/tree/main/packages/%40agent-browser/eve) for the complete options and example app.

[Read the full extension documentation](https://github.com/vercel-labs/agent-browser/tree/main/packages/%40agent-browser/eve)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)