Launch Chrome

~/.claude/skills/chrome-automation/scripts/launch.sh [URL]

The script automatically checks if Chrome is already running.

Or launch manually:

export DISPLAY=:1
export GTK_MODULES=gail:atk-bridge
export NO_AT_BRIDGE=0
export GNOME_ACCESSIBILITY=1

google-chrome \
    --no-sandbox \
    --disable-gpu \
    --start-maximized \
    --force-renderer-accessibility \
    --no-first-run \
    "https://google.com" &

Restart Chrome

~/.claude/skills/chrome-automation/scripts/launch.sh restart [URL]

Control Chrome (after launching)

List clickable elements:

chrome-a11y list

Click an element:

chrome-a11y click "Button Name"

Navigate to URL:

chrome-a11y navigate "https://example.com"

Type text:

chrome-a11y type "search query"

Send keyboard shortcut:

chrome-a11y key "ctrl+t"   # New tab
chrome-a11y key "ctrl+l"   # Focus address bar

Stop Chrome

pkill -9 chrome

Important Notes

Must run in background with & to avoid blocking
--force-renderer-accessibility is required for AT-SPI2 control
--no-sandbox is required when running as root
Wait 3-5 seconds after launch before using chrome-a11y

Prerequisites

Ensure these are installed:

TigerVNC running on :1
AT-SPI2 packages: gir1.2-atspi-2.0, at-spi2-core, python3-gi
The chrome-a11y tool in PATH

For detailed documentation, see REFERENCE.md.

chrome-automation

Chrome Automation

Quick Start

Check if Chrome is Running