ext claude-code-bridge v1.9.1

Claude Code Bridge Extension

The browser half of the bridge

Manifest V3 · Chrome & Edge · WebSocket client · Content script injection

Install Guide Source

# What It Can Do

👁

Read Pages

Accessibility tree parsing, full text extraction, and DOM structure analysis. Works on any tab including backgrounded ones.

› Accessibility tree

› Full page text

› Element search by text/role/aria

🖱

Interact

Click, type, scroll, fill forms, and upload files via content script injection. React/Vue-compatible event dispatch.

› Click / type / scroll

› Form input with framework compat

› File upload

⚡

Execute & Monitor

Run arbitrary JavaScript, capture console output, monitor network requests, and record interactions as GIFs.

› JavaScript execution

› Console message capture

› Network request monitoring

# Architecture

┌─────────────────────────────────────────────────────────┐
│  Extension (Manifest V3)                                │
│                                                         │
│  background.js (service worker)                        │
│     ├── WebSocket client → ws://127.0.0.1:18963        │
│     ├── chrome.tabs API (navigate, list, create)        │
│     ├── chrome.scripting (JS execution)                  │
│     ├── Persistent port messaging (reliable on Android)  │
│     └── 15s heartbeat / auto-reconnect                  │
│                                                         │
│  content.js (injected per-tab)                         │
│     ├── DOM interaction (click, type, scroll)            │
│     ├── Accessibility tree with WeakMap ref index         │
│     ├── Form input with native setter + event dispatch    │
│     └── Console interceptor (log, warn, error)           │
│                                                         │
│  popup.html (diagnostics UI)                           │
│     └── Connection status, message log (200 entries)     │
│                                                         │
└─────────────────────────────────────────────────────────┘

Native Messaging Protocol

4-byte LE length prefix + UTF-8 JSON.
Max message size: 1 MiB.

CDP Integration

Browser-level DevTools Protocol connection.
Network monitoring, device metrics, target management.
Port configurable via BRIDGE_PORT.

# Permissions

Permission	Why
tabs	List, navigate, and create browser tabs
scripting	Execute JavaScript and inject content scripts
activeTab	Access the currently active tab
webRequest	Monitor network requests for CDP integration
cookies	Access cookies for authenticated page context
<all_urls>	Content script injection on any page

All communication stays on localhost. No data is sent to external servers. See the privacy policy.

# Known Limitations

No screenshot on Android Edge

captureVisibleTab is unavailable on mobile Edge. The bridge falls back to ADB screencap when ADB is connected.

Service worker suspension

Edge may suspend the background service worker after idle. The extension auto-reconnects when woken by a new tool call.

Protected pages

chrome://, edge://, and extension pages block content script injection. These tabs can still be listed and navigated.

CRX install is manual

Android Edge has no programmatic extension install API. The --setup command serves the CRX and opens Edge, but you must tap "Add extension" manually.

# Source Files

edge-claude-ext/

├── manifest.json Manifest V3 config, permissions, service worker

├── background.js Service worker — WS client, tab management, tool dispatch

├── content.js DOM interaction, accessibility tree, form handling

├── popup.html Diagnostics popup — connection status, message log

├── popup.js Popup logic — status display, log rendering

└── launcher.html Bridge launch page (cfcbridge:// URL handler)