# Install this skill (skills.sh)
npx skills add ironbee-ai/ironbee-devtools-skills
 
# Install the CLI binary
npm install -g @ironbee-ai/devtools

# Navigate to a URL
ironbee-browser-devtools-cli navigation go-to --url "https://example.com"
 
# Take a screenshot
ironbee-browser-devtools-cli content take-screenshot --name "homepage"
 
# Get page content as text
ironbee-browser-devtools-cli content get-as-text

# JSON output for parsing, quiet mode for clean output, session for state persistence
ironbee-browser-devtools-cli --json --quiet --session-id "my-session" <command>

ironbee-browser-devtools-cli daemon status      # Check daemon status
ironbee-browser-devtools-cli daemon info        # Show daemon info (version, uptime, sessions)
ironbee-browser-devtools-cli daemon start       # Start daemon
ironbee-browser-devtools-cli daemon stop        # Stop daemon
ironbee-browser-devtools-cli daemon restart     # Restart daemon

ironbee-browser-devtools-cli session list                  # List active sessions
ironbee-browser-devtools-cli session info <session-id>     # Show session details
ironbee-browser-devtools-cli session delete <session-id>   # Delete a session

ironbee-browser-devtools-cli tools list              # List all available tools
ironbee-browser-devtools-cli tools search <query>    # Search tools by name or description
ironbee-browser-devtools-cli tools info <tool-name>  # Show tool details and parameters

ironbee-browser-devtools-cli config    # Show current configuration

ironbee-browser-devtools-cli update --check   # Check for updates
ironbee-browser-devtools-cli update           # Check and install updates

# Navigate to URL
ironbee-browser-devtools-cli navigation go-to --url "https://example.com"
 
# Take screenshot
ironbee-browser-devtools-cli content take-screenshot --name "homepage"
 
# Get page text
ironbee-browser-devtools-cli content get-as-text

# Use same session for state persistence
SESSION="--session-id login-test"
 
# Navigate to login page
ironbee-browser-devtools-cli $SESSION navigation go-to --url "https://app.example.com/login"
 
# Fill form fields
ironbee-browser-devtools-cli $SESSION interaction fill --selector "#email" --value "user@example.com"
ironbee-browser-devtools-cli $SESSION interaction fill --selector "#password" --value "password123"
 
# Submit form
ironbee-browser-devtools-cli $SESSION interaction click --selector "button[type=submit]"
 
# Wait for navigation
ironbee-browser-devtools-cli $SESSION sync wait-for-network-idle
 
# Capture result
ironbee-browser-devtools-cli $SESSION content take-screenshot --name "dashboard"

# Navigate
ironbee-browser-devtools-cli navigation go-to --url "https://example.com"
 
# Get Web Vitals metrics
ironbee-browser-devtools-cli --json o11y get-web-vitals
 
# Check console for errors
ironbee-browser-devtools-cli --json o11y get-console-messages --type warning
 
# Analyze HTTP requests
ironbee-browser-devtools-cli --json o11y get-http-requests

# Navigate
ironbee-browser-devtools-cli navigation go-to --url "https://example.com"
 
# Get ARIA snapshot
ironbee-browser-devtools-cli a11y take-aria-snapshot
 
# Get detailed AX tree
ironbee-browser-devtools-cli --json a11y take-ax-tree-snapshot --roles button,link,textbox

# Run JavaScript in session VM (page + callTool available)
ironbee-browser-devtools-cli run execute --code "return await page.title();"
 
# Batch multiple tools in one call (fewer round-trips)
ironbee-browser-devtools-cli run execute --code "await callTool('a11y_take-aria-snapshot', {}, true); await callTool('content_take-screenshot', {}, true);"
 
# Run script body from a file (mutually exclusive with --code)
ironbee-browser-devtools-cli run execute --file ./scripts/login-flow.js

# Register a scenario at the project scope
ironbee-browser-devtools-cli default scenario-add \
  --name "login-flow" \
  --description "Logs in and verifies dashboard" \
  --script "await callTool('navigation_go-to', { url: 'https://app.example.com/login' });"
 
# Discover available scenarios
ironbee-browser-devtools-cli default scenario-list
ironbee-browser-devtools-cli default scenario-search --query "login"
 
# Run a scenario directly (scenario-run is a CLI subcommand on every platform)
ironbee-browser-devtools-cli default scenario-run --name login-flow
 
# Parameterize: --args JSON, or repeatable --param key=value (coerced to declared param types)
ironbee-browser-devtools-cli default scenario-run --name login-flow --param email=user@example.com
 
# Step-based: steps go in one --body JSON flag (setup/teardown are their own JSON flags)
ironbee-browser-devtools-cli default scenario-add \
  --name "checkout-smoke" \
  --description "Open the cart, check out, verify the confirmation" \
  --body '{"steps":[{"type":"tool-call","tool":"navigation_go-to","input":{"url":"{{args.baseUrl}}/cart"}},{"type":"llm-action","name":"complete-checkout","intent":"Fill the checkout form with the test card and submit it"}]}'
 
# An llm-action pauses the run: resolve it, see what you called, then resume + freeze the realization
ironbee-browser-devtools-cli default scenario-recorded-actions --name checkout-smoke
ironbee-browser-devtools-cli default scenario-run --name checkout-smoke --resume --cache '{"script":"await callTool(\"interaction_click\", { selector: \"#submit\" });"}'

# Mock API response
ironbee-browser-devtools-cli stub mock-http-response \
  --pattern "**/api/users" \
  --body '[{"id": 1, "name": "Test User"}]'
 
# Navigate and test
ironbee-browser-devtools-cli navigation go-to --url "https://app.example.com"
 
# Clear mocks
ironbee-browser-devtools-cli stub clear

SESSION="--session-id debug-session"
 
# Navigate to app
ironbee-browser-devtools-cli $SESSION navigation go-to --url "http://localhost:3000"
 
# Set tracepoint on a function
ironbee-browser-devtools-cli $SESSION debug put-tracepoint \
  --url-pattern "app.js" \
  --line-number 42
 
# Add watch expression
ironbee-browser-devtools-cli $SESSION debug add-watch --expression "this"
 
# Enable exception catching
ironbee-browser-devtools-cli $SESSION debug put-exceptionpoint --state uncaught
 
# Interact with app (triggers probes)
ironbee-browser-devtools-cli $SESSION interaction click --selector "#submit-btn"
 
# Get captured snapshots
ironbee-browser-devtools-cli $SESSION --json debug get-probe-snapshots
ironbee-browser-devtools-cli $SESSION --json debug get-probe-snapshots --types tracepoint,exceptionpoint

#!/bin/bash
set -e
 
CLI="ironbee-browser-devtools-cli --json --quiet --session-id ci-test-$$"
 
# Navigate
$CLI navigation go-to --url "https://example.com"
 
# Wait for load
$CLI sync wait-for-network-idle
 
# Take screenshot
$CLI content take-screenshot --name "ci-test"
 
# Get Web Vitals
VITALS=$($CLI o11y get-web-vitals)
echo "Web Vitals: $VITALS"
 
# Check for console errors
ERRORS=$($CLI o11y get-console-messages --type error)
if [ "$ERRORS" != "[]" ]; then
  echo "Console errors found: $ERRORS"
  exit 1
fi
 
# Cleanup
$CLI session delete "ci-test-$$"

ironbee-browser-devtools-cli interactive
ironbee-browser-devtools-cli --no-headless interactive   # With visible browser

# Bash
ironbee-browser-devtools-cli completion bash
echo 'eval "$(ironbee-browser-devtools-cli completion bash)"' >> ~/.bashrc
 
# Zsh
ironbee-browser-devtools-cli completion zsh
echo 'eval "$(ironbee-browser-devtools-cli completion zsh)"' >> ~/.zshrc