remote-browser

--- name: remote-browser description: Controls a cloud 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. allowed-tools: Bash(browser-use:*) --- # Remote Browser Automation for Sandboxed Agents This skill is for agents running on **sandboxed remote machines** (cloud VMs, CI, coding agents) that need to control a browser. Install `browser-use` and drive a cloud browser — no local Chrome needed. ## Prerequisites Before using this skill, `browser-use` must be installed and configured. Run diagnostics to verify: ```bash browser-use doctor ``` For more information, see https://github.com/browser-use/browser-use/blob/main/browser_use/skill_cli/README.md ## Core Workflow Commands use the cloud browser: ```bash # Step 1: Start session (automatically uses remote mode) browser-use open https://example.com # Returns: url, live_url (view the browser in real-time) # Step 2+: All subsequent commands use the existing session browser-use state # Get page elements with indices browser-use click 5 # Click element by index browser-use type "Hello World" # Type into focused element browser-use input 3 "text" # Click element, then type browser-use screenshot # Take screenshot (base64) browser-use screenshot page.png # Save screenshot to file # Done: Close the session browser-use close # Close browser and release resources ``` ## Essential Commands ```bash # Navigation browser-use open <url> # Navigate to URL browser-use back # Go back browser-use scroll down # Scroll down (--amount N for pixels) # Page State (always run state first to get element indices) browser-use state # Get URL, title, clickable elements browser-use screenshot [... prompt truncated for preview ...]