Bdg

bdg https://example.com --headless      # Start a session (Chrome + daemon); stays up until bdg stop
bdg dom query "button"                  # Find elements: [0], [1], ... (0-based)
bdg dom inspect "button.primary"        # Box, layout, font, colors + contrast, without a screenshot
bdg dom fill "input[name='email']" "a@b.co"
bdg dom click "button[type='submit']"   # Prints what changed: navigation, new text, or no effect
bdg console --level error               # Anything thrown?
bdg network list --preset errors        # 4xx/5xx responses
bdg stop                                # Only when completely done

bdg status                    # Current session (bdg status --verbose for diagnostics)
bdg peek                      # Preview collected requests and console messages
bdg sessions                  # All sessions, default and named
bdg <url> --session mobile --mobile --headless   # A second, named session (own Chrome)
bdg --session mobile eval "innerWidth"           # Every command takes --session <name> (or BDG_SESSION)
bdg <url> --viewport 1280x800 --color-scheme dark
bdg -q dom query "a"          # -q: minimal output, no "Next:" hints

bdg page navigate https://example.com/next   # Load a URL and wait for it
bdg page back                                # Also: page forward
bdg page reload
bdg page info                                # URL and title

✓ Element Clicked
Page: navigated to https://app.test/secure (200)    # navigation (or "URL changed ... (same document)")
New text: "Your password is invalid!" (div#flash)   # alert/status/aria-live messages that appeared
⚠ Element Clicked (no visible effect observed ...)  # nothing changed - wrong element or a broken handler
Download: report.txt → ~/.bdg/downloads/report.txt (completed, 15 B)  # files go to <session dir>/downloads

bdg dom form --brief                           # Fields: index, type, label, required
bdg dom fill "input[name='user']" "myuser"     # By selector (React-compatible)
bdg dom fill 0 "value"                         # By index from the last query/form
bdg dom click "button.submit" --index 1        # Second match
bdg dom submit "form" --wait-navigation        # Traditional form post
bdg dom pressKey "input" Enter
bdg dom scroll "footer"                        # Or --down 500, --bottom
bdg dom wait '.toast' --text 'Saved'           # Also --visible, --gone, --load

bdg dom get "h1"                     # Semantic a11y summary (--raw for HTML)
bdg dom a11y query role=button       # By accessibility role/name
bdg dom inspect ".card" --why color  # Which CSS rule set a property, and what it overrode
bdg dom layout ".card"               # Every match: position, size, above/below the fold, hidden, covered
bdg dom audit                        # Page-wide: contrast, overflow, fixed layers, animations
bdg dom audit contrast --level AAA
bdg css search -- --brand            # Where a CSS text/custom property is set and used (file:line)
bdg dom listeners "#save"            # Event listeners that run for an element
bdg page emulate --mobile            # Mid-session: phone viewport, touch, mobile UA
bdg page emulate --viewport 390x844 --color-scheme dark
bdg page emulate --reset

text   Arial 600 16/24 · color #1a1a1a · contrast 17.4 AAA on #fff · align start   # font size/line-height (px)

bdg eval "document.body.innerText.includes('Success')"
bdg eval "[...document.querySelectorAll('a')].map(a => ({text: a.textContent, href: a.href}))" --json | jq '.data.result'
bdg dom frames                                 # The page's iframes, cross-origin ones too
bdg eval --frame pay "document.title"          # In an iframe: index, name/id, or part of its URL

bdg network list                              # Requests (DevTools-style)
bdg network list --filter "status-code:>=400 domain:api.*"   # DevTools DSL: status-code:, domain:, method:, mime-type:, ! negates; space = AND
bdg details network <id>                      # Headers, timing, body of one request
bdg network getCookies
bdg console --level error                     # Errors on the current page
bdg console --follow                          # Streams (blocks; agents re-run bdg console instead)
bdg network har /tmp/session.har              # Export HAR 1.2 (credentials redacted; --include-sensitive keeps them)

bdg cdp Page.getLayoutMetrics --json | jq '.data.result.cssVisualViewport'
bdg cdp Emulation.setCPUThrottlingRate --params '{"rate": 4}'   # rate: 1 resets
bdg cdp --search cookie                 # Discover: --list, Network --list, <Method> --describe