Back to Skills

remote-browser

Controls a local browser from a sandboxed remote machine. Use when the agent is running in a sandbox (no GUI) and needs to navigate websites, interact with web pages, fill forms, take screenshots, or expose local dev servers via tunnels.

94,693stars10,679forksUpdated 5/20/2026

Security Assessment

Safe(100/100)
Security Score100/100

About remote-browser

The `remote-browser` skill enables agents running on sandboxed or headless environments to control a local browser remotely. This is particularly useful in environments where a graphical interface is unavailable, such as cloud virtual machines, continuous integration pipelines, or other remote coding agents. By providing a structured interface to navigate websites, interact with page elements, fill forms, take screenshots, and manage local development servers via tunnels, it addresses the challenge of automating web tasks in restricted execution contexts.

Key features of this skill include comprehensive browser automation capabilities such as navigation, tab management, scrolling, and element interaction through clicks, typing, and selections. Users can extract data by evaluating JavaScript, retrieving text, HTML, attributes, or bounding boxes of elements. Advanced interactions include uploading files, hovering, double-clicking, right-clicking, and sending keyboard commands. The skill also supports waiting for elements or text to appear and managing cookies. Multiple browser modes are available, including headless Chromium, cloud browser connections, and connecting via CDP URLs. Screenshots can be captured either as base64 or saved to disk, and browser sessions persist between commands to optimize workflow efficiency.

This skill is ideal for developers, QA engineers, or automation specialists who need to perform browser-based automation without direct GUI access. Common use cases include testing web applications in CI/CD pipelines, automating repetitive web tasks, scraping or extracting structured data from websites, and exposing local development servers to remote environments. Its flexibility and comprehensive command set allow users to perform almost any interaction typically possible in a full browser, making it an essential tool for automation in sandboxed or remote environments.

FAQ

How do I start a browser session using the remote-browser skill?

Use the command `browser-use open <url>` to start a headless browser session and navigate to the specified URL. The browser remains open between commands until you explicitly close it with `browser-use close`.

Can I use this skill on a machine without a graphical interface?

Yes, the skill is designed for sandboxed or headless environments where no GUI is available. It controls the browser remotely and supports headless Chromium or cloud-based browser connections.

How can I interact with elements on a web page?

First, run `browser-use state` to get a list of clickable elements with indices. Then, use commands like `browser-use click <index>`, `browser-use input <index> "text"`, or `browser-use select <index> "option"` to interact with the elements.

What are the prerequisites for using this skill?

You need to verify that `browser-use` is installed by running `browser-use doctor`. Additional setup details are available at the official GitHub repository for browser-use.

Can I extract data from a page using this skill?

Yes, you can extract page data using commands such as `browser-use eval "js code"`, `browser-use get text <index>`, `browser-use get html [--selector "css"]`, or `browser-use get attributes <index>`.

Install remote-browser

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill