Browser Bridge Setup

⚠️ Important: Browser commands reuse your Chrome login session. You must be logged into the target website in Chrome before running commands.

OpenCLI connects to your browser through a lightweight Browser Bridge Chrome Extension + micro-daemon (zero config, auto-start).

Extension Installation

Method 1: Download Pre-built Release (Recommended)

1. Go to the GitHub Releases page and download the latest opencli-extension.zip or opencli-extension.crx.
2. Open chrome://extensions and enable Developer mode (top-right toggle).
3. Drag and drop the .crx file or the unzipped folder into the extensions page.

Method 2: Load Unpacked Source (For Developers)

1. Open chrome://extensions and enable Developer mode.
2. Click Load unpacked and select the extension/ directory from the repository.

Verification

That's it! The daemon auto-starts when you run any browser command. No tokens, no manual configuration.

opencli doctor            # Check extension + daemon connectivity
opencli doctor --live     # Also test live browser commands

How It Works

┌─────────────┐     WebSocket      ┌──────────────┐     Chrome API     ┌─────────┐
│  opencli    │ ◄──────────────► │  micro-daemon │ ◄──────────────► │  Chrome  │
│  (Node.js)  │    localhost:19825  │  (auto-start) │    Extension       │ Browser  │
└─────────────┘                    └──────────────┘                    └─────────┘

The daemon manages the WebSocket connection between your CLI commands and the Chrome extension. The extension executes JavaScript in the context of web pages, with access to the logged-in session.