Skip to main content
The bridge at ws://127.0.0.1:8765/ws routes messages between CLI clients, the bridge’s BrowserAgent and the Chrome extension.

Quick Start

1

Register as the extension (JavaScript)

2

Start a session as a CLI client (Python)


Message Catalog


Roles

Each socket is an extension, a CLI, or neither, decided at connect time. See Role Registration for the handshake.

Error Codes


Best Practices

Wait for the registered status before sending start_session on the same socket.
Send heartbeat about every 20 seconds from the extension.
Branch on the code field, not the error text.

Extension Architecture

How the CLI, bridge and extension fit together

Browser Agent Deep Dive

Engines, modes and troubleshooting