Start a browser session. Optional — any tool will auto-start Chrome if no browser is open. Use this to choose Firefox, enable headless mode, or set a custom window size.

Navigate the browser to a URL.

Take a screenshot and return it as base64.

Return the current page HTML source.

Return the current page title.

Return the current URL.

Close and quit the browser session.

Navigate back in browser history.

Navigate forward in browser history.

Refresh the current page.

Execute JavaScript in the browser.

Switch to a browser window/tab by index.

Open a new browser tab, optionally navigating to a URL.

Close the currently active tab and switch to the previous one.

List all open browser tabs/windows with their index, title, and URL.

Scroll the page to the very top.

Scroll the page to the very bottom.

Scroll the page by a given number of pixels (positive = down/right).

Emulate a mobile device using Chrome DevTools Protocol. Adjusts viewport, pixel ratio, and touch.

Return browser console logs (errors, warnings, info). Chrome only.

Return all cookies for the current page, or a single cookie by name.

Set a cookie on the current page.

Delete a specific cookie by name.

Delete all cookies for the current session.

Get a value from localStorage, or return all keys if no key is given.

Set a localStorage key-value pair.

Get a value from sessionStorage, or return all keys if no key is given.

Set a sessionStorage key-value pair.

Discover all interactive elements on the current page — inputs, buttons, selects, checkboxes, textareas, and links — with their best CSS selectors and labels. Use this before writing locators so the AI knows exactly what's on the page.

Return captured XHR/fetch network requests (method, URL, status, timing). Chrome only.

Intercept fetch/XHR requests matching a URL pattern and return a canned response. Useful for testing without a real backend. Injection survives until the page is reloaded.

Remove all active mock response rules injected by mock_response.

Compare the current page screenshot against a saved baseline. On first run (or with update_baseline=true) saves the baseline. Returns the pixel diff percentage. Install Pillow for accurate pixel comparison.

Run a built-in accessibility audit on the current page. Checks for missing alt text, unlabelled inputs, empty buttons/links, missing page title, HTML lang, heading structure, and keyboard accessibility.

Wait until there are no active XHR/fetch requests for a quiet period. Essential for SPAs and pages that load data asynchronously. Also waits for document.readyState to be 'complete'.

Find an element and return its text, tag, and attributes.

Find all matching elements and return their texts.

Click on an element.

Clear and type text into an input field.

Get the visible text content of an element.

Get an attribute value from an element.

Select an option from a dropdown by visible text, value, or index.

Hover the mouse over an element.

Double-click on an element.

Right-click (context menu) on an element.

Drag one element and drop it onto another.

Check if an element is visible on the page.

Check if an element is enabled (not disabled).

Wait until an element is visible on the page.

Scroll the page to bring an element into view.

Clear the text in an input field.

Fill multiple form fields in a single call. Pass a map of CSS selector → value. Automatically handles text inputs, textareas, checkboxes (true/false), radio buttons, and dropdowns. Optionally clicks a submit button at the end.

Return all self-healed locator mappings from this session. Shows which selectors were automatically repaired and what they were replaced with.

Clear the self-healing locator cache so all selectors are re-evaluated from scratch.

Accept (OK) a JavaScript alert, confirm, or prompt dialog.

Dismiss (Cancel) a JavaScript confirm or prompt dialog.

Return the text message of a currently open JavaScript alert/confirm/prompt.

Type text into a JavaScript prompt dialog, then accept it.

Switch focus into an iframe. Provide index (integer), name/id (string), or a CSS/XPath selector.

Switch back to the main page content from inside a frame.

Send a key or key combination to the focused element (or a specific element if selector is given). Use key names like 'tab', 'enter', 'escape', 'up', 'down', 'f5', or combos like 'ctrl+a', 'shift+tab'.

Upload a file by sending its absolute path to an element.

Find an element inside a shadow DOM. Provide the host element selector and then the selector for the element inside the shadow root.

Extract data from an HTML table as a formatted text grid.

Assert the page title equals or contains expected text.

Assert the current URL equals or contains expected value.

Assert element text equals or contains expected value.

Assert an element is visible on the page.

Assert an element is NOT visible (hidden or absent).

Assert an element attribute has the expected value.

Assert the full page source or visible text contains a string.

Assert number of elements matching selector equals expected count.

Generate a pytest + Selenium test script from the current browser session. Captures all recorded actions (navigate, click, type, hover, drag, select, etc.) into a runnable test.

Generate a Java TestNG test class from the current browser session. framework='testfly' (default) emits a TestFly test (extends BaseTest, framework-managed driver, open(), accessibility-first getByRole/getByLabel/getByTestId/find locators and web-first assertThat assertions — no driver lifecycle boilerplate). framework='testng' emits standalone raw Selenium with a ChromeDriver setUp/tearDown.

Generate a Java JUnit 5 test class from the current browser session. framework='testfly' (default) emits a TestFly test (extends BaseJUnit5Test, framework-managed driver, open(), accessibility-first locators and web-first assertThat assertions). framework='junit5' emits standalone raw Selenium with a ChromeDriver setUp/tearDown.

Detect whether the current working directory is inside a TestFly project (looks for testfly.yml or the io.testfly dependency in pom.xml / build.gradle, walking up parent directories). Call this BEFORE generating Java code: if it reports detected=true, generate with framework="testfly" so the output uses the framework's accessibility-first locators, open(), and managed driver.

Backward-compatible alias for detect_testfly. Detects whether the current working directory is inside a TestFly project.

Generate a production-ready testfly.yml configuration file tailored to the current session or customized via arguments.

Generate a standard Maven pom.xml pre-configured with TestFly 1.0.0, Java 17+, maven-compiler-plugin, and maven-surefire-plugin.

Return the raw list of recorded actions in the current session.

Clear the recorded action log and start fresh.

Generate a Cucumber Gherkin .feature file + Java step definitions class + TestNG Cucumber runner from the recorded browser session. framework='testfly' (default) emits steps extending BaseCucumberSteps with framework-managed driver, open(), accessibility-first locators, web-first assertThat, and a RunCucumberTest runner extending BaseCucumberTest. framework='raw' emits standalone Selenium.

Generate a C# NUnit + Selenium test class from the current browser session.

Generate a GitHub Actions CI workflow YAML for running the recorded test session.

Generate a declarative Jenkinsfile for running the recorded test session (Maven, Gradle, or pytest).

Generate a .gitlab-ci.yml pipeline for running the recorded test session (Maven, Gradle, or pytest).

Generate equivalent Playwright (TypeScript) code hints from the recorded browser session.

Generate a Java Page Object class + matching test class from the recorded session. USE THIS INSTEAD OF WRITING JAVA BY HAND — the output compiles as-is and contains only the elements/actions actually performed, so it never invents fields or uses non-existent framework APIs. Produces two files: a Page Object (locators + fluent action methods) and a Test class that uses it. Supports TestFly (framework='testfly', default): Page Object extends BasePage, Test extends BaseTest, framework manages driver lifecycle, accessibility-first locators and web-first assertThat assertions. framework='testng'/'junit5' emit standalone raw Selenium.