go build -o rodney .

rodney start # Launch headless Chrome rodney start --show # Launch with visible browser window rodney start --insecure # Launch with TLS errors ignored (-k shorthand) rodney connect host:9222 # Connect to existing Chrome on remote debug port rodney status # Show browser info and active page rodney stop # Shut down Chrome

rodney open https://example.com # Navigate to URL rodney open example.com # http:// prefix added automatically rodney back # Go back rodney forward # Go forward rodney reload # Reload page rodney reload --hard # Reload bypassing cache rodney clear-cache # Clear the browser cache

rodney url # Print current URL rodney title # Print page title rodney text "h1" # Print text content of element rodney html "div.content" # Print outer HTML of element rodney html # Print full page HTML rodney attr "a#link" href # Print attribute value rodney pdf output.pdf # Save page as PDF

rodney js document.title # Evaluate expression rodney js "1 + 2" # Math rodney js 'document.querySelector("h1").textContent' # DOM queries rodney js '[1,2,3].map(x => x * 2)' # Returns pretty-printed JSON rodney js 'document.querySelectorAll("a").length' # Count elements

rodney click "button#submit" # Click element rodney input "#search" "query" # Type into input field rodney clear "#search" # Clear input field rodney file "#upload" photo.png # Set file on a file input rodney file "#upload" - # Set file from stdin rodney download "a.pdf-link" # Download href/src target to file rodney download "a.pdf-link" - # Download to stdout rodney select "#dropdown" "value" # Select dropdown by value rodney submit "form#login" # Submit a form rodney hover ".menu-item" # Hover over element rodney focus "#email" # Focus element

rodney wait ".loaded" # Wait for element to appear and be visible rodney waitload # Wait for page load event rodney waitstable # Wait for DOM to stop changing rodney waitidle # Wait for network to be idle rodney sleep 2.5 # Sleep for N seconds

rodney screenshot # Save as screenshot.png rodney screenshot page.png # Save to specific file rodney screenshot -w 1280 -h 720 out.png # Set viewport width/height rodney screenshot-el ".chart" chart.png # Screenshot specific element

rodney pages # List all tabs (* marks active) rodney newpage https://... # Open URL in new tab rodney page 1 # Switch to tab by index rodney closepage 1 # Close tab by index rodney closepage # Close active tab

rodney exists ".loading" # Exit 0 if exists, exit 1 if not rodney count "li.item" # Print number of matching elements rodney visible "#modal" # Exit 0 if visible, exit 1 if not rodney assert 'document.title' 'Home' # Exit 0 if equal, exit 1 if not rodney assert 'document.querySelector("h1") !== null' # Exit 0 if truthy

rodney ax-tree # Dump full accessibility tree rodney ax-tree --depth 3 # Limit tree depth rodney ax-tree --json # Output as JSON rodney ax-find --role button # Find all buttons rodney ax-find --name "Submit" # Find by accessible name rodney ax-find --role link --name "Home" # Combine filters rodney ax-find --role button --json # Output as JSON rodney ax-node "#submit-btn" # Inspect element's a11y properties rodney ax-node "h1" --json # Output as JSON

# CI check: verify all buttons have accessible names rodney ax-find --role button --json | python3 -c " import json, sys buttons = json.load(sys.stdin) unnamed = [b for b in buttons if not b.get('name', {}).get('value')] if unnamed:  print(f'FAIL: {len(unnamed)} button(s) missing accessible name')  sys.exit(1) print(f'PASS: all {len(buttons)} buttons have accessible names') "

rodney start --local # State stored in ./.rodney/state.json # Chrome data in ./.rodney/chrome-data/ rodney open https://example.com # Auto-detects local session rodney stop # Cleans up local session

# Force global even when a local session exists rodney --global open https://example.com # Force local (errors if no local session) rodney --local status

rodney --local start rodney start --local # Same effect rodney open --global https://example.com

# Wait for page to load and extract data rodney start rodney open https://example.com rodney waitstable title=$(rodney title) echo "Page: $title" # Conditional logic based on element presence if rodney exists ".error-message"; then rodney text ".error-message" fi # Loop through pages for url in page1 page2 page3; do rodney open "https://example.com/$url" rodney waitstable rodney screenshot "${url}.png" done rodney stop

rodney exists "h1" # Prints "true", exits 0 rodney exists ".nonexistent" # Prints "false", exits 1

rodney visible "#modal" # Prints "true" and exits 0 if the element exists and is visible rodney visible "#hidden-div" # Prints "false" and exits 1 if the element is hidden or doesn't exist

rodney ax-find --role button --name "Submit" # Prints the matching node(s), exits 0 rodney ax-find --role banner --name "Nonexistent" # Prints "No matching nodes" to stderr, exits 1

# Truthy mode — check that expression evaluates to a truthy value rodney assert 'document.querySelector(".logged-in") !== null' # Prints "pass", exits 0 rodney assert 'document.querySelector(".nonexistent")' # Prints "fail: got null", exits 1 # Equality mode — check that expression result matches expected value rodney assert 'document.title' 'Dashboard' # Prints "pass" if title is "Dashboard", exits 0 rodney assert 'document.querySelectorAll(".item").length' '3' # Prints "pass" if there are exactly 3 items, exits 0 rodney assert 'document.title' 'Wrong Title' # Prints 'fail: got "Dashboard", expected "Wrong Title"', exits 1

rodney assert 'document.querySelector(".logged-in")' -m "User should be logged in" # On failure: "fail: User should be logged in (got null)" rodney assert 'document.title' 'Dashboard' --message "Wrong page loaded" # On failure: 'fail: Wrong page loaded (got "Home", expected "Dashboard")'

#!/bin/bash set -euo pipefail FAIL=0 check() { if ! "$@"; then echo "FAIL: $*" FAIL=1 fi } rodney start rodney open "https://example.com" rodney waitstable # Assert elements exist check rodney exists "h1" check rodney exists "nav" check rodney exists "footer" # Assert key elements are visible check rodney visible "h1" check rodney visible "#main-content" # Assert JS expressions check rodney assert 'document.title' 'Example Domain' check rodney assert 'document.querySelectorAll("p").length' '2' check rodney assert 'document.querySelector("h1") !== null' # Assert accessibility requirements check rodney ax-find --role navigation check rodney ax-find --role heading --name "Example Domain" rodney stop if [ "$FAIL" -ne 0 ]; then echo "Some checks failed" exit 1 fi echo "All checks passed"