browser

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

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

2. Verify Page Load

   playwright-cli snapshot
   

   Report page title and URL from snapshot output.

3. 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