quay 0.1.0

Chrome DevTools with accessibility-tree semantics

Quay — Chrome DevTools with Accessibility Semantics

Quay combines Chrome DevTools Protocol with accessibility-tree semantics for browser automation using your authenticated Chrome sessions.

Why Quay?

Feature	Quay	Playwright	agent-browser	Raw CDP
Accessibility tree	✅	❌	✅	❌
Uses your logged-in Chrome	✅	❌	❌	❌
Connection pooling	✅	❌	❌	❌
Auto-reconnect	✅	❌	❌	❌
Python-native	✅	✅	❌	❌
Session recording	✅	❌	❌	❌
Weight	~20KB	~MB	~MB	~5MB

Installation

pip install quay

Or from source:

git clone https://github.com/sidonsoft/quay
cd quay
pip install -e .

Prerequisites

Chrome must be running with remote debugging enabled:

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

# Linux
google-chrome --remote-debugging-port=9222

# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

Or use the included launcher:

./scripts/chrome-debug.sh

Quick Start

Python API

from quay import Browser

browser = Browser()
browser.goto("https://gmail.com")  # Uses your logged-in session

tree = browser.accessibility_tree()
print(tree.to_tree_str())

browser.click_by_text("Sign in")
browser.fill_form({"Email": "[e-mail]"})

CLI

# List tabs
quay list

# Open new tab
quay new https://example.com

# Get accessibility tree
quay snapshot

# Take screenshot
quay screenshot

# Click by text
quay click "Submit"

Features

Feature	Description
Accessibility Tree	Navigate pages using AX nodes like agent-browser
Session Reuse	Uses your existing Chrome session (no separate browser)
Connection Pooling	WebSocket reuse across operations for speed
Auto-Reconnect	Automatically reconnects on connection drop
Session Recording	Record and replay browser actions
Form Filling	Fill forms by label text
Click by Text	Click elements matching visible text
JavaScript Eval	Run arbitrary JavaScript

Automatic Reconnection

Quay automatically detects dropped connections and reconnects:

browser = Browser(reconnect=True, reconnect_max_retries=3)

# If connection drops during operation,
# Quay will attempt to reconnect automatically
tree = browser.accessibility_tree()  # May auto-reconnect if needed

Monitor reconnection with a callback:

def on_reconnect(msg):
    print(f"Reconnecting: {msg}")

browser = Browser(reconnect_callback=on_reconnect)

License

Apache-2.0 - See LICENSE for details.