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
Register before start_session
Register before start_session
Wait for the
registered status before sending start_session on the same socket.Keep the socket alive
Keep the socket alive
Send
heartbeat about every 20 seconds from the extension.Handle error replies
Handle error replies
Branch on the
code field, not the error text.Related
Extension Architecture
How the CLI, bridge and extension fit together
Browser Agent Deep Dive
Engines, modes and troubleshooting

