name

verdict

description

Token-efficient browser verification for AI coding agents. Use instead of Playwright MCP for all browser testing — page verification, click flows, form fills, CSS inspection, screenshots. Costs ~50-100 tokens per call vs ~1500 for MCP tools. Use when verifying web pages, checking UI renders, testing forms, inspecting CSS values, taking screenshots, or debugging frontend issues. Also use when the user mentions browser testing, page verification, visual QA, or responsive design checking.

Verdict

Token-efficient browser verification via Bash. Use this instead of Playwright MCP for all browser verification.

Setup (auto-runs on first use)

cd <project-root> && npm install verdict-cli 2>/dev/null || true
B="node_modules/.bin/verdict"

Quick Reference

# Navigate and verify
node $B goto <url>
node $B snapshot -i              # ARIA refs for interactive elements
node $B click @e3                # Click by ref
node $B fill @e5 "text"          # Fill input
node $B snapshot -D              # Diff: verify action changed page

# Inspect
node $B css @e3 font-size        # Computed CSS value
node $B inspect @e3              # Full box model + styles
node $B console                  # JS errors
node $B network                  # Network requests

# Visual
node $B screenshot /tmp/page.png
node $B responsive /tmp          # Mobile + tablet + desktop
node $B viewport 375x812         # Set viewport

# Auth (for pages requiring login)
node $B handoff                  # Opens visible Chrome for manual login
# ... log in ...
node $B resume                   # Back to headless
node $B auth-save myapp          # Save session encrypted
node $B goto-auth <url> --profile myapp  # Auto-load auth

Intent → Command

I want to...	Command
Check page loads	`goto <url>` then `snapshot -i`
Verify action changed page	`snapshot -D`
Check CSS value	`css @eN <property>`
Full box model + styles	`inspect @eN`
Take screenshot	`screenshot /tmp/page.png`
Test form	`fill @eN "val"` then `click @eM` then `snapshot -D`
Check JS errors	`console`
Test responsive	`responsive /tmp`
Multiple checks at once	`chain [["goto","url"],["snapshot","-i"],["console"]]`

When NOT to use (fall back to Playwright MCP)

Drag and drop interactions
Pixel-level screenshot comparison
When the task plan explicitly says QA Tool: PLAYWRIGHT_MCP

Verdict

Token-efficient browser verification via Bash. Use this instead of Playwright MCP for all browser verification.

Setup (auto-runs on first use)

cd <project-root> && npm install verdict-cli 2>/dev/null || true B="node_modules/.bin/verdict"

Quick Reference

# Navigate and verify node $B goto <url> node $B snapshot -i # ARIA refs for interactive elements node $B click @e3 # Click by ref node $B fill @e5 "text" # Fill input node $B snapshot -D # Diff: verify action changed page # Inspect node $B css @e3 font-size # Computed CSS value node $B inspect @e3 # Full box model + styles node $B console # JS errors node $B network # Network requests # Visual node $B screenshot /tmp/page.png node $B responsive /tmp # Mobile + tablet + desktop node $B viewport 375x812 # Set viewport # Auth (for pages requiring login) node $B handoff # Opens visible Chrome for manual login # ... log in ... node $B resume # Back to headless node $B auth-save myapp # Save session encrypted node $B goto-auth <url> --profile myapp # Auto-load auth

Intent → Command

I want to...

Command

Check page loads

goto <url> then snapshot -i

Verify action changed page

snapshot -D

Check CSS value

css @eN <property>

Full box model + styles

inspect @eN

Take screenshot

screenshot /tmp/page.png

Test form

fill @eN "val" then click @eM then snapshot -D

Check JS errors

console

Test responsive

responsive /tmp

Multiple checks at once

chain [["goto","url"],["snapshot","-i"],["console"]]

When NOT to use (fall back to Playwright MCP)

Drag and drop interactions

Pixel-level screenshot comparison

When the task plan explicitly says QA Tool: PLAYWRIGHT_MCP