| name | web-browser |
| description | Browse the web using agent-browser CLI with Lightpanda engine. Read pages, extract content, interact with elements. |
| user-invocable | true |
Web Browser (agent-browser + Lightpanda)
Use agent-browser CLI via exec for all web browsing tasks.
Default engine: Lightpanda (fast, low-RAM). Falls back to Chrome if needed.
Quick Reference
Open a page
agent-browser open https://example.com
Get page content (text snapshot)
agent-browser snapshot
agent-browser snapshot -i
agent-browser snapshot -c
agent-browser snapshot -s "#main-content"
Interact with elements
Snapshots return refs like @e1, @e2. Use them to interact:
agent-browser click @e3
agent-browser fill @e5 "text"
agent-browser type @e5 "text"
agent-browser select @e7 "value"
agent-browser press @e5 Enter
agent-browser hover @e2
agent-browser scroll @e1
Navigation
agent-browser back
agent-browser forward
agent-browser open <new-url>
Typical Workflow
exec("agent-browser open https://example.com") - open page
exec("agent-browser snapshot") - read page content
- If need to interact:
exec("agent-browser snapshot -i") - get interactive elements with refs
exec("agent-browser click @e3") - click element
exec("agent-browser snapshot") - check result
Engine Selection
agent-browser --engine lightpanda open https://example.com
agent-browser --engine chrome open https://example.com
agent-browser screenshot
agent-browser screenshot --annotate
Use Chrome engine only when Lightpanda fails on a complex site or you need a screenshot.
Notes
- Lightpanda: no screenshots, no visual rendering, but 10x faster and 10x less RAM
- Refs (
@e1) persist across exec calls — daemon stays alive between commands
snapshot — full text for reading; snapshot -i — refs for clicking; snapshot -c — layout only
- Google and some sites block headless browsers from cloud IPs (empty page) — use web_search instead
- If a site crashes with Lightpanda, retry with
--engine chrome