Run a sandboxed JavaScript script against a persistent browser (SawyerHood/dev-browser).

This is the main tool. Prefer it whenever you need more than a single navigation/click/fill.

Sandbox is QuickJS, not Node.js: no require/import/fs/fetch/process. Available: browser.getPage(nameOrId), browser.newPage(), browser.listPages(), browser.closePage(name) saveScreenshot(buf, name), writeFile(name, data), readFile(name), console.*, setTimeout Pages are Playwright Page objects (goto, click, fill, locator, evaluate, screenshot, snapshotForAI, getByRef, getByRole, waitForSelector, waitForURL, cua, domCua).

Write small scripts. Named pages persist. End with console.log of the next-decision state. On local dev servers use { waitUntil: "domcontentloaded" }.

List named pages and open browser tabs: [{id, url, title, name}].

Get or create a named page (or attach to a tab by targetId from list_pages) and return url/title.

Close and unregister a named page.

Navigate a named page to a URL. Prefer waitUntil=domcontentloaded for local dev servers.

Return an AI-friendly accessibility snapshot. Use refs like e12 with getByRef in a later run, or pass snapshotRef to click/fill/type.

Take a PNG screenshot of a named page and return the image plus the saved path under ~/.dev-browser/tmp/.

Click an element by CSS selector or snapshotRef from dev_browser_snapshot (e.g. e12).

Fill an input by CSS selector or snapshotRef. Replaces existing value.

Type into an element character by character, by CSS selector or snapshotRef.

Evaluate JavaScript in the page. Pass a browser-side expression or statements.

Wait until a selector reaches the given state on a named page.

Show the dev-browser daemon status, idle timeout, and managed browsers.

List daemon-managed browser instances and their named pages.

Stop the dev-browser daemon and close every browser it launched.

Install the Playwright Chromium build used by daemon-launched browsers.