agent-browser
Browser automation for AI agents via inference.sh. Navigate web pages, interact with elements using @e refs, take screenshots, record video. Capabilities: web scraping, form filling, clicking, typing, drag-drop, file upload, JavaScript execution. Use for: web automation, data extraction, testing, ag
By 101-skills · 11,928 installs
npx skills add 101-skills/superpowers --skill agent-browser
Source repository · Upstream listing
Install the belt CLI skill: npx skills add belt sh/cli
Agentic Browser
Browser automation for AI agents via [inference.sh](https://inference.sh). Uses Playwright under the hood with a simple @e ref system for element interaction.

Quick Start
Requires inference.sh CLI ( belt ). [Install instructions](https://raw.githubusercontent.com/inference sh/skills/refs/heads/main/cli install.md)
Core Workflow
Every browser automation follows this pattern:
1. Open Navigate to URL, get @e refs for elements
2. Interact Use refs to click, fill, drag, etc.
3. Re snapshot After navigation/changes, get fresh refs
4. Close End session (returns video if recording)
Functions
Function Description
open Navigate to URL, configure browser (viewport, proxy, video recording)
snapshot Re fetch page state with @e refs after DOM changes
interact Perform actions using @e refs (click, fill, drag, upload, etc.)
screenshot Take page screenshot (viewport or full page)
execute Run JavaScript code on the page
close Close session, returns video if recording was enabled
Interact Actions
Action Description Required Fields
click Click element ref
dblclick Double click element ref
fill Clear and type text ref , text
type Type text (no clear) text
press Press key (Enter, Tab, etc.) text
select Select dropdown option ref , text
hover Hover over element ref
check Check checkbox ref
uncheck Uncheck checkbox ref
drag Drag and drop ref , target ref
upload Upload file(s) ref , file paths
scroll Scroll page direction (up/down/left/right), scroll amount
back Go back in history
wait Wait milliseconds wait ms
goto Navigate to URL url
Element Refs
Elements are returned with @e refs:
Important: Refs are invalidated after navigation. Always re snapshot after:
Clicking links/buttons that navigate
Form submissions
Dynamic content loading
Features
Video Recording
Record browser sessions for debugging or documentation:
Cursor Indicator
Show a visible cursor in screenshots and video (useful for demos):
The cursor appears as a red dot that follows mouse movements and shows click feedback.
Proxy Support
Route traffic through a proxy server:
File Upload
Upload files to file inputs:
Drag and Drop
Drag elements to targets:
JavaScript Execution
Run custom JavaScript:
Deep Dive Documentation
Reference Description
[references/commands.md](references/commands.md) Full function reference with all options
[references/snapshot refs.md](references/snapshot refs.md) Ref lifecycle, invalidation rules, troubleshooting
[references/session management.md](references/session management.md) Session persistence, parallel sessions
[references/authentication.md](references/authentication.md) Login flows, OAuth, 2FA handling
[references/video recording.md](references/video recording.md) Recording workflows for debugging
[references/proxy support.md](references/proxy support.md) Proxy configuration, geo testing
Ready to Use Templates
Template Description
[templates/form automation.sh](templates/form automation.sh) Form filling with validation
[templates/authenticated session.sh](templates/authenticated session.sh) Login once, reuse session
[templates/capture workflow.sh](templates/capture workflow.sh) Content extraction with screenshots
Examples
Form Submission
Search and Extract
Screenshot with Video
Sessions
Browser state persists within a session. Always:
1. Start with session new on first call
2. Use returned session id for subsequent calls
3. Close session when done
Related Skills
Documentation
[inference.sh Sessions](https://inference.sh/docs/extend/sessions) Session management
[Multi function Apps](https://inference.sh/docs/extend/multi function apps) How functions work