core

github:vercel-labs/agent-browser · first committed 2026-04-16 · source · badge

Core agent-browser usage guide. Read this before running any agent-browser commands. Covers the snapshot-and-ref workflow, navigating pages, interacting with elements (click, fill, type, select), extracting text and data, taking screenshots, managing tabs, handling forms and auth, waiting for content, running multiple browser sessions in parallel, and troubleshooting common failures. Use when the

Skill Health: not yet scored

Listed, not yet scored. This skill has no public model test yet. It is in the scoring queue; submitted skills go first, then the most-installed.

Version history

69 commits to this file on GitHub (newest first).

2026-10-31 · commit 5868f7c · fix: validate session names before use (#2272)
2026-10-31 · commit 0b123cb · fix(install): check macOS before Chrome download (#2270)
2026-10-31 · commit 426100c · fix(skills): find home skills in standalone installations (#2277)
2026-10-31 · commit b612020 · fix(tab): reject labels reserved for tab IDs (#2276)
2026-10-31 · commit 0f9ddf3 · fix(cli): print React tree in plain output (#2266)
2026-10-31 · commit 9d6b6fa · fix(install): allow root dependency installs (#2264)
2026-10-31 · commit 573de3c · fix: report failed load-state waits (#2251)
2026-10-30 · commit 28898e4 · fix: require trust for advanced project settings (#2283)
2026-10-30 · commit 8939035 · feat: send CDP WebSocket headers for generic --cdp URLs (#2005)
2026-10-30 · commit 66d4c07 · docs(sandbox): document the stdin MCP server in Vercel Sandbox (#2248)
2026-10-29 · commit 50d81fc · feat(eve): build the extension's tools from the MCP tool catalog (#2241)
2026-10-29 · commit badee9b · feat(mcp): run one MCP tool with `mcp call` (#2238)
2026-10-26 · commit b8ff127 · fix(cli): recover sessions whose tab stopped responding (#2100)
2026-10-23 · commit df247a9 · fix(mcp): stop extraArgs from overriding the operator's limits (#2181)
2026-10-20 · commit fd93075 · fix(refs): refuse ambiguous stale-ref recovery (#2145)
2026-10-20 · commit 1508546 · fix(mcp): reject arguments the tool schema does not declare (#2175)
2026-10-08 · commit 0207911 · feat(cli): trust private CAs in CLI HTTPS requests (#2006)
2026-10-06 · commit 1b1a683 · feat(engine): add experimental Obscura support (#1876)
2026-09-16 · commit f5b0b48 · fix: synchronize recording cursor and mouse movement timing (#1869)
2026-09-15 · commit 7e4aa1d · Add automatic snapshot deltas (#1811)
2026-09-15 · commit 8f58d0a · feat: add conditional screenshots (#1813)
2026-09-15 · commit 0fd2c53 · feat: preserve refs across snapshots (#1812)
2026-09-15 · commit 0ae29e5 · feat: add interpolated mouse movement (#1810)
2026-09-15 · commit b6d1e3a · feat: add visible cursor to recordings (#1808)
2026-09-15 · commit 007ac2f · Add recording contact sheets (#1807)
2026-09-15 · commit 8bbddb8 · Discover WebMCP tools with compact summaries on change (#1842)
2026-09-10 · commit 8c15ff9 · Clarify reliable browser wait strategies (#1834)
2026-09-10 · commit a156ff5 · fix(select): match normalized option labels (#1736)
2026-09-09 · commit 08cc9d5 · Add no-navigate auth login mode (#1771)
2026-09-08 · commit 3725815 · Fix Windows headless Chrome desktop artifacts (#1498) (#1820)
2026-09-07 · commit 8f9133b · [cli] Record: require ffmpeg up front, validate output extension (#1778)
2026-09-07 · commit 219c47a · [cli] New tabs inherit the session's setup (#1777)
2026-09-07 · commit 8000618 · [cli] record: capture the current page instead of a fresh context (#1776)
2026-09-06 · commit 4726ece · feat: advertise WebMCP tools after navigation (#1760)
2026-09-03 · commit 4a98df7 · feat: record at 30 fps by default, up to 60, from Page.startScreencast (#1763)
2026-09-01 · commit c6785b8 · feat: add experimental WebMCP support (#1757)
2026-08-31 · commit 4a89c19 · fix(dashboard): harden origin validation (#1738)
2026-08-30 · commit 784264a · fix(cdp): normalize root WebSocket request paths (#1735)
2026-08-26 · commit 8934fdb · fix(stream): emit active main-frame URL updates (#1682)
2026-08-24 · commit 021d925 · docs(skills): add protected Vercel deployment access (#1705)
2026-08-20 · commit b041bd4 · feat(cli): trust proxy CAs through Chromium NSS (#1669)
2026-08-10 · commit 861e76d · feat(session): persistent session tab binding with --pin-tab (#1589)
2026-07-31 · commit 3aa6c75 · feat(stream): configurable screencast quality and frame size (#1626)
2026-07-30 · commit 2158803 · feat(stream): input priority and latest-frame-wins delivery with per-client maxFps (#1594)
2026-07-24 · commit 3cc7022 · feat(native): ship a default 1h daemon idle timeout (#1605)
2026-07-23 · commit 1ed371f · fix(native): revive discarded tabs on tab switch instead of hanging the daemon (#1532)
2026-07-23 · commit cee334e · feat: add a11y command for axe-core accessibility audits (#1596)
2026-07-22 · commit 5185039 · fix(native): match implicit ARIA roles and accessible names in find role (#1552)
2026-07-22 · commit ee38cbf · fix(native): preserve locator detail in element-not-found errors (#1553)
2026-07-19 · commit ad97a04 · Embed response bodies in HAR captures (#1578)
2026-07-16 · commit e40e62d · Lowercase eve brand name in docs (#1557)
2026-07-15 · commit 6818db7 · Fix wait handling for completed pages (#1554)
2026-07-15 · commit ce68e2c · fix: block WebRTC domain allowlist bypass (#1546)
2026-07-14 · commit 3591f0f · Add eve browser extension (#1547)
2026-07-13 · commit f5d0d38 · feat: add WebGPU launch preset (#1529)
2026-07-08 · commit afae698 · Add periodic restore state autosave (#1509)
2026-06-25 · commit b680ab0 · Harden agent session lifecycle (#1486)
2026-06-24 · commit fa00e1e · Add agent-readable read command (#1480)
2026-06-20 · commit bd93bf0 · docs: avoid hard-wrapped prose (#1466)
2026-06-20 · commit f0ceebd · Add agent-browser sandbox package (#1465)
2026-06-16 · commit a982ea0 · Add MCP server with startup profiles (#1454)
2026-06-16 · commit e2b4c04 · Add plugin system (#1452)
2026-06-10 · commit 688e285 · Detect click interception by overlays (#1434)
2026-06-01 · commit f35d578 · Improve vitals output (#1404)
2026-06-01 · commit 2a7120e · docs: surface agent-browser feature coverage (#1403)
2026-05-27 · commit b4f2f37 · Hide scrollbars in headless screenshots (#1396)
2026-04-20 · commit 57405f9 · feat(react): React introspection, Web Vitals, and SPA primitives (#1257)
2026-04-16 · commit 14ece9b · feat: add `doctor` command for diagnosing installs and cleaning stale daemon state (#1254)
2026-04-16 · commit 4cc6ca4 · feat(skills): rename "agent-browser" skill to "core"; make CLI-served main skill actually useful (#1253)

Archived snapshots