version: "1.0.0" name: browser description: "Opens browser at URL for E2E testing via playwright-cli. Provides CLI commands for navigation, screenshots, and interaction. Triggers on keywords: browser, open browser, playwright browser, e2e browser" project-agnostic: true allowed-tools:

• Bash
• Read

Browser Command

Open browser for E2E testing using playwright-cli.

Target URL: $ARGUMENTS

If no URL provided, default to: http://localhost:${DEFAULT_PORT:-5173}/

Pre-Flight Checks

1. Verify playwright-cli Installed

• Run: playwright-cli --help
• If not available: STOP with error "playwright-cli not installed. Run: npm install -g @playwright/cli@latest && playwright-cli install-browser"

Execution

1. Navigate to URL

``bash playwright-cli open "${URL:-http://localhost:${DEFAULT_PORT:-5173}/}" ``

1. Verify Page Load

``bash playwright-cli snapshot `` Report page title and URL from snapshot output.

1. Report Status

• Confirm browser is open and ready
• Display current page title
• Display current URL

Available CLI Commands

After opening browser, these commands are available via Bash:

• playwright-cli goto <url> - Navigate to URL
• playwright-cli snapshot - Capture accessibility snapshot
• playwright-cli click "<selector>" - Click element
• playwright-cli fill "<selector>" "<text>" - Fill input field
• playwright-cli type "<text>" - Type text
• playwright-cli screenshot - Take PNG screenshot
• playwright-cli close - Close browser session
• playwright-cli video-start / video-stop - Record video

Notes

• Video recording is explicit: use playwright-cli video-start before the flow and video-stop after
• Configure output via playwright-cli.json in project root
• Use --headed flag for visible browser window: playwright-cli --headed open <url>
• Port can be configured via DEFAULT_PORT environment variable
• Sessions persist across commands: use playwright-cli -s=<name> for named sessions