Edge Agent Bridge

Control your real, active Microsoft Edge tabs directly from Python scripts and CLI commands.

Standard browser automation frameworks like Playwright, Puppeteer, and Selenium always spin up clean temporary profiles that don't have your logged-in cookies, which ends up triggering bot checks or breaking on company SSO portals. Edge Agent Bridge skips that headache by attaching straight to your running browser window, so you don't lose your active session, enterprise VPN, or saved logins. It dispatches hardware-level inputs through Chrome DevTools Protocol over a local RFC 6455 WebSocket.

Measured Benchmarks

Hard benchmark and stress test suite executed against live Microsoft Edge tabs (tests/test_benchmark_hard.py):

Run the Benchmark Suite Locally

python tests/test_benchmark_hard.py

Installation

pip install edge-agent-bridge

Runs on Python 3.8+ without installing external packages.

Fast Setup

1. Install the Microsoft Edge Extension

You can install the extension via either method:

• Method A (Microsoft Edge Add-ons Store): Install the official Edge Agent Bridge extension from the Microsoft Edge Add-ons Store.
• Method B (Developer Mode / Unpacked):
  1. Open edge://extensions in Edge and toggle Developer mode on.
  2. Run in terminal:

     edge-bridge extension open
     

  3. Click Load unpacked and select that directory.

2. Verify Connection

Run in terminal:

edge-bridge status

When Microsoft Edge is open, the bridge daemon connects instantly over 127.0.0.1:18999 with sub-15ms WebSocket latency.

Python API

from edge_agent_bridge import Edge

with Edge() as browser:
    tab = browser.tab()
    print("Active:", tab["tab"]["title"])

    browser.nav("https://news.ycombinator.com")
    browser.hover("past")
    browser.click("comments")
    browser.fill("Search:", "AI agents")

    elements = browser.elements()
    print(f"Found {len(elements)} targets")

    browser.screenshot("hn.png")

Command Line Interface

# Check daemon and socket state
edge-bridge status

# Query active tab
edge-bridge tab

# List open tabs or jump to specific ID
edge-bridge tabs
edge-bridge switch 1234

# Hover by visible text label or coordinates
edge-bridge hover "Settings"
edge-bridge hover --x 450 --y 320

# Hardware click with trusted events
edge-bridge click "Sign In"
edge-bridge click "#submit-button"

# Double click, right click, or drag and drop
edge-bridge dblclick "File_01.pdf"
edge-bridge rightclick "Folder A"
edge-bridge drag "Task 1" "Done Column"

# Fill inputs and dispatch keyboard keys
edge-bridge fill "Search query" "LangChain vs AutoGPT"
edge-bridge key Enter
edge-bridge key Ctrl+A

# Extract element text or take viewport snapshots
edge-bridge text "#results-count"
edge-bridge screenshot output.png

# In-memory action batching (single round-trip multi-step execution)
edge-bridge batch '[{"action":"click","x":450,"y":320},{"action":"sleep","ms":50},{"action":"fill","target":"Search","text":"AI Agents"}]'

Interactive REPL

If you're running repeated actions and want to skip Python startup overhead, launch the interactive shell:

edge-bridge repl

=== Edge Bridge Real-Time Interactive REPL ===
edge> tab
[11.8ms] {"success": true, "tab": {"id": 1459, "title": "GitHub"}}
edge> click "Pull requests"
[14.2ms] {"success": true, "x": 380, "y": 96, "native": true}
edge> fill "Type / to search" "bugfix"
[18.9ms] {"success": true, "text": "bugfix", "native": true}

Architecture & Security Model

• RFC 6455 Streaming & Frame Reassembly: Full support for multi-frame continuation sequences (opcode=0) when Chromium fragments payloads >64KB (full-page DOM dumps, multi-megabyte screenshots).
• Fast Integer-XOR Unmasking: Standard-library integer XOR unmasks multi-megabyte WebSocket payloads in <1ms without C-extensions or external dependencies.
• Localhost only: The daemon binds strictly to 127.0.0.1:18999 and refuses remote network traffic.
• Origin check: Any browser page attempting to open ws://127.0.0.1:18999/ws gets rejected with 403 Forbidden, meaning web pages you browse cannot hijack the bridge.
• Zero telemetry: Nothing leaves your computer. Zero external network calls.

Support & Sponsorship

Edge Agent Bridge is built by Shanewas Ahmed.

If this project saves you engineering hours or simplifies your agent workflows, consider supporting its development:

• GitHub Sponsors: github.com/sponsors/shanewas
• Buy Me a Coffee: buymeacoffee.com/shanewas
• Ko-fi: ko-fi.com/shanewas

Sponsorship helps fund keeping CDP handlers aligned with rapid Chromium engine updates and maintaining zero-dependency Python packages.

License

MIT License. See LICENSE for details.