Brittle locators in.
Semantic queries out.

Paste a Playwright or Selenium script. The same parse → translate → generate pipeline as the CLI rewrites CSS/XPath call sites into an AgentQL query_elements script — instantly, in the browser.

ParseWalk locator(), fill/click, and find_element call sites.

TranslateName each control from test ids, name, type, then classes.

GenerateEmit a sync Playwright module that queries by role, not path.

Legacy scriptsample_legacy.py

"""
Dummy legacy Playwright script with brittle CSS/XPath locators.

Used as the end-to-end fixture for the Legacy-to-AgentQL Migrator.
The AST parser (`parser.py`) should discover four locator call sites below.
"""

from playwright.sync_api import sync_playwright


def run_legacy_login_flow() -> None:
    """Simulate a fragile selector-heavy login workflow."""
    with sync_playwright() as playwright:
        browser = playwright.chromium.launch(headless=True)
        page = browser.new_page()
        page.goto("https://example.com/login")

        # Brittle nested CSS path for the username field
        page.locator("div#app > div.container > form.login-form > input[name='user']").fill(
            "demo_user"
        )

        # Deeply nested list-item button for password visibility toggle
        page.locator("div > ul.toolbar > li:nth-child(2) > button.icon-eye").click()

        # Complex attribute selector for the password input
        page.locator("form[action='/auth/login'] input[type='password'][data-testid='pwd']").fill(
            "s3cret!"
        )

        # XPath-style fragile submit control
        page.locator("//div[@id='footer']//button[contains(@class, 'btn-primary')]").click()

        browser.close()


if __name__ == "__main__":
    run_legacy_login_flow()

Generated AgentQL4 fields

"""
Auto-generated AgentQL migration of sample_legacy.py.

Regenerate with ``python generator.py`` — do not hand-edit locators here.
Requires AGENTQL_API_KEY (see .env.example).
"""

import agentql
from playwright.sync_api import sync_playwright

QUERY = """
{
    user_input
    icon_eye_button
    pwd_input
    btn_primary_button
}
"""


def run_migrated_flow() -> None:
    """Run the migrated flow with semantic AgentQL selectors."""
    with sync_playwright() as playwright:
        browser = playwright.chromium.launch(headless=True)
        page = agentql.wrap(browser.new_page())
        page.goto('https://example.com/login')

        elements = page.query_elements(QUERY)
        elements.user_input.fill('demo_user')
        elements.icon_eye_button.click()
        elements.pwd_input.fill('s3cret!')
        elements.btn_primary_button.click()

        browser.close()


if __name__ == "__main__":
    run_migrated_flow()

Locator map

4 locators3 css1 xpathURL https://example.com/login

{
    user_input
    icon_eye_button
    pwd_input
    btn_primary_button
}

Line	Action	Kind	Brittle selector	AgentQL name
19	fill	css	div#app > div.container > form.login-form > input[name='user']	user_input
24	click	css	div > ul.toolbar > li:nth-child(2) > button.icon-eye	icon_eye_button
27	fill	css	form[action='/auth/login'] input[type='password'][data-testid='pwd']	pwd_input
32	click	xpath	//div[@id='footer']//button[contains(@class, 'btn-primary')]	btn_primary_button

This demo runs the CLI's heuristic translator in the browser (the same names you get from python migrator.py --fallback). The Python CLI can also call gpt-4o-mini when OPENAI_API_KEY is set. Generated scripts need AGENTQL_API_KEY at runtime.

Brittle locators in.Semantic queries out.

Locator map

Brittle locators in.
Semantic queries out.