Agent Chrome Bridge

Last updated: November 16, 2026

A free, open-source bridge giving local AI coding assistants (Google Antigravity, Claude Code, Cursor, Codex) the ability to interact directly with your existing Google Chrome browser where your sessions and developer logins already exist.

Why This Matters

Standard AI sandboxes (such as headless Playwright containers) boot an empty browser instance with no stored logins, cookies, or extensions. When you ask an agent to check Search Console impressions, inspect GitHub pull requests, or debug Cloudflare DNS, it is stopped by login screens and two-factor authentication gates.

Agent Chrome Bridge bridges this gap: the Chrome extension attaches locally via the Chrome DevTools Protocol (CDP). The agent views your open tabs, inspects interactive elements, and dispatches trusted input events directly in your active browser session.

How the Agent Sees Your Browser

Rather than struggling with brittle CSS selectors, the look command labels all actionable buttons and inputs with numeric tags ([1], [2]), while the shot command exports an annotated JPEG snapshot featuring the virtual cursor position.

Agent Chrome Bridge self-test interface: numbered elements and virtual cursor overlay

Self-test snapshot: visual element tags and real-time cursor indicator overlaid on page components.

5-Step Quick Setup

  1. Download the package: get agent-chrome-bridge-2.2.0.zip or clone from GitHub.
  2. Open Chrome Extensions: navigate to chrome://extensions and toggle on Developer mode in the top-right corner.
  3. Load Unpacked: click Load unpacked and select the extension/ folder.
  4. Start Daemon: double-click start.bat (Windows) or execute ./start.sh (macOS / Linux). The script verifies Python 3.9+ and starts the server on 127.0.0.1:8766.
  5. Run Verification: open a terminal and execute:
    python server/br.py selftest
    All 12 end-to-end tests will complete with 12/12 PASS.

CLI Reference (`br.py`)

Security & Safety Boundaries

Frequently Asked Questions

Does it work with Claude Code, Cursor, and Antigravity?

Yes. Any local agent with CLI execution permissions can run python server/br.py <command>. Copy the ready-made prompt from AGENT_RULES.md into your agent instructions.

Why not use Playwright or Puppeteer directly?

Playwright spawns a clean profile by default. Agent Chrome Bridge attaches to your running browser where your daily accounts and 2FA authentications are already unlocked.

What is the yellow debugger banner in Chrome?

This is standard Chromium behavior whenever Chrome DevTools Protocol attaches to a tab. It confirms that mouse and keyboard events are dispatched at the engine level.