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

# Browse CLI

> Use the Browse CLI to drive browser automation, Browserbase cloud APIs, and Browse.sh skills from AI coding agents.

The unified Browserbase CLI now lives under the `browse` command. You can use it for browser automation, Browserbase cloud APIs, Functions, templates, and skill installation.

Use the Browse CLI when you want your agent to stay in the terminal for workflows like:

* **Browser automation** — `browse open`, `snapshot`, `click`, `fill`, `type`, `upload`, `screenshot`, `wait`, and `viewport`
* **Navigation and inspection** — `browse back`, `forward`, `reload`, `highlight`, `refs`, `get`, `is`, `eval`, and `cdp`
* **Session controls** — `browse status`, `stop`, `cursor`, `tab`, `network`, and `mouse`
* **Cloud APIs** — `browse cloud` for Browserbase projects, sessions, contexts, extensions, fetch, and search APIs
* **Functions** — `browse functions` for function development, publishing, and invocation
* **Skills and templates** — `browse skills` and `browse templates` for reusable browser workflows and scaffolds

<Info>
  The `browse` CLI is the current Browserbase CLI surface.
</Info>

## Choose the right skill

| Skill        | Best for                                                                                           |
| ------------ | -------------------------------------------------------------------------------------------------- |
| `browser`    | Interactive browser automation powered by the `browse` CLI                                         |
| `fetch`      | Lightweight page retrieval via the Browserbase Fetch API                                           |
| `functions`  | Focused Browserbase Functions workflows                                                            |
| `browse-cli` | Unified `browse` workflows across browser automation, cloud APIs, functions, skills, and templates |

## Installation

<Tabs>
  <Tab title="Browse CLI">
    <Steps>
      <Step title="Install the Browse CLI">
        ```bash theme={null}
        npm install -g browse
        ```
      </Step>

      <Step title="Install the bundled skill">
        ```bash theme={null}
        browse skills install
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Vercel Skills CLI">
    <Steps>
      <Step title="Install the skill">
        ```bash theme={null}
        npx skills add browserbase/skills --skill browser
        ```
      </Step>

      <Step title="Install the Browse CLI">
        ```bash theme={null}
        npm install -g browse
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code plugins">
    <Steps>
      <Step title="Add the Browserbase marketplace">
        ```bash theme={null}
        claude plugin marketplace add browserbase/skills
        ```
      </Step>

      <Step title="Install the browse plugin">
        ```bash theme={null}
        claude plugin install browse@browserbase --scope local
        ```
      </Step>

      <Step title="Install the Browse CLI">
        ```bash theme={null}
        npm install -g browse
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Command surface

The current top-level `browse` topics are:

* `cloud` for Browserbase cloud resources and APIs
* `functions` for Browserbase Functions
* `mouse` for raw mouse coordinate input
* `network` for browser network capture
* `skills` for discovering and installing browser automation skills
* `tab` for tab management
* `templates` for scaffolding Browserbase templates

The current top-level browser commands are:

* `back`, `forward`, `reload`, `open`, and `wait`
* `snapshot`, `refs`, `highlight`, `screenshot`, and `cursor`
* `click`, `fill`, `type`, `upload`, `select`, `key`, and `press`
* `get`, `is`, `eval`, `viewport`, `status`, `stop`, and `cdp`

## Authentication

Remote Browserbase commands require your API key:

```bash theme={null}
export BROWSERBASE_API_KEY="your_api_key"
```

## Common workflows

### Browser automation

```bash theme={null}
browse open https://example.com
browse snapshot
browse click @0-4
browse fill @0-7 "hello@example.com"
browse screenshot
```

### Cloud APIs

```bash theme={null}
browse cloud projects list
browse cloud sessions get <session_id>
browse cloud contexts create
browse cloud extensions upload ./my-extension.zip
```

### Functions

```bash theme={null}
browse functions init my-function
cd my-function
browse functions dev index.ts
browse functions publish index.ts
browse functions invoke <function_id> --params '{"url":"https://example.com"}'
```

### Skills

```bash theme={null}
browse skills list
browse skills find reviews
browse skills add yelp.com/extract-reviews
```

## Browse.sh

Browse.sh is an open-source catalog of skills for reliable web tasks.

It gives your agents researched playbooks for hundreds of sites.

## Further reading

<CardGroup cols={2}>
  <Card title="Skills repository" icon="github" iconType="sharp-solid" href="https://github.com/browserbase/skills">
    View the Browserbase skills source and installation instructions.
  </Card>

  <Card title="Browse.sh" icon="arrow-up-right-from-square" iconType="sharp-solid" href="https://browse.sh">
    Explore the public Browse.sh skill catalog.
  </Card>
</CardGroup>