glidercli 0.3.5 → 0.3.7

package/README.md

@@ -1,187 +1,275 @@
 <div align="center">
 
-<img src="assets/icons/glider-blue-squircle.webp" alt="glider" width="80" height="80" />
-<img src="assets/icons/chrome.webp" alt="chrome" width="80" height="80" />
-<img src="assets/icons/claude.webp" alt="claude" width="80" height="80" />
-<img src="assets/icons/ralph-wiggum.webp" alt="ralph" width="80" height="80" />
+<img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/glider.webp" alt="glider" width="80" height="80" />
+<img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/chrome.webp" alt="chrome" width="80" height="80" />
+<img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/claude.webp" alt="claude" width="80" height="80" />
+<img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/ralph-wiggum.webp" alt="ralph" width="80" height="80" />
 
-<h1 align="center">glidercli</h1>
-<p align="center"><i><b>Browser automation CLI with autonomous loop execution.</b></i></p>
+<h1 align="center">glider CLI</h1>
+<p align="center"><i><b>Browser automation CLI with autonomous loop execution</b></i></p>
 
 [![Github][github]][github-url]
 [![npm][npm]][npm-url]
-
 </div>
 
 <br/>
 
-## ToC
+## About
 
-<ol>
-    <a href="#about">About</a><br/>
-    <a href="#install">Install</a><br/>
-    <a href="#usage">Usage</a><br/>
-    <a href="#the-loop">The loop</a><br/>
-    <a href="#task-files">Task files</a><br/>
-    <a href="#commands">Commands</a><br/>
-    <a href="#roadmap">Roadmap</a><br/>
-    <a href="#tools-used">Tools</a><br/>
-    <a href="#contact">Contact</a>
-</ol>
+| | |
+|---|---|
+| **What** | Control a **Chromium-based** browser from the terminal via CDP, run YAML tasks, and loop until done (Ralph Wiggum pattern) |
+| **CDP** | Chrome DevTools Protocol via relay + browser extension |
+| **Tasks** | Declarative steps: `goto`, `click`, `explore`, `eval`, `screenshot` |
+| **Loops** | Run until completion marker or max iterations / timeout |
+| **Safety** | Max iterations, timeout, backoff |
 
-<br/>
+---
 
-## About
+## Install
 
-Control Chrome from terminal. Run YAML tasks. Loop until complete (Ralph Wiggum pattern).
+| Step | Action |
+|------|--------|
+| **1. CLI** | `npm i -g glidercli` |
+| **2. Extension** | [Install Glider from Chrome Web Store](https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj) in the same browser/profile you will automate (required, bridges relay ↔ tab) |
+| **3. Daemon** | `glider install` then `glider connect` |
+| **4. Browser (required setup)** | Configure supported browser/profile + extension in the **Browsers** section below. |
 
-- **CDP-based** - Direct Chrome DevTools Protocol (CDP) control
-- **YAML tasks** - Define automation steps declaratively  
-- **Autonomous loops** - Run until completion marker found
-- **Safety guards** - Max iterations, timeout, exponential backoff
 
-## Install
+## Requirements
 
-**One-liner:**
-```bash
-npm i -g glidercli && open "https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj"
-```
+| Requirement | Minimum |
+|-------------|---------|
+| Node | 18+ |
+| Browser | Chromium-based (Chrome, Arc, Edge, Brave, Opera, Vivaldi) with the Glider extension installed/enabled in that browser profile. No Firefox/Safari/DuckDuckGo |
 
-**Then:**
-```bash
-glider install    # start daemon (runs forever, auto-restarts)
-glider connect    # connect to Chrome
-```
+---
 
-**Update anytime:**
-```bash
-glider update     # pulls latest from npm
+## Browsers
+
+| | |
+|---|---|
+| **How it works** | Chrome extension → WebSocket relay → CDP. Browser must support that extension (Chromium-based). |
+
+### Browser support
+
+Icons: `https://raw.githubusercontent.com/vdutts7/squircle/main/webp/{slug}.webp` ([squircle](https://github.com/vdutts7/squircle)).
+
+**Extension:** Install [Glider](https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj) from the Chrome Web Store in each browser/profile you plan to automate
+
+| | Browser | Config |
+|:---:|--------|--------|
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/chrome.webp" width="16" alt=""> | Google Chrome | Default for `glider connect`. |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/arc.webp" width="16" alt=""> | Arc | [browser.json](config/browser.json.example) (`{ "use": "arc" }`) |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/microsoft/microsoft-edge.webp" width="16" alt=""> | Microsoft Edge | n/a |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/brave.webp" width="16" alt=""> | Brave | n/a |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/opera-gx.webp" width="16" alt=""> | Opera | n/a |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/vivaldi.webp" width="16" alt=""> | Vivaldi | n/a |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/chromium.webp" width="16" alt=""> | Other Chromium | Must support installing extensions from the Chrome Web Store. |
+
+### Future
+
+- not supported today
+- Glider needs a **Chromium-based** browser that can install the extension from the **Chrome Web Store**
+- no timeline implied- listed for clarity
+
+
+| | Browser | Notes |
+|:---:|--------|--------|
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/firefox.webp" width="16" alt=""> | Firefox | **Gecko** (Firefox engine). Not Chromium, Glider uses a Chrome Web Store extension + CDP |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/firefox-focus.webp" width="16" alt=""> | Firefox Focus | Gecko- same constraints as Firefox |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/firefox.webp" width="16" alt=""> | Firefox Klar | Gecko (Focus branding in some regions)- same constraints as Firefox |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/librewolf.webp" width="16" alt=""> | LibreWolf | Gecko- same constraints as Firefox |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/waterfox.webp" width="16" alt=""> | Waterfox | Gecko- same constraints as Firefox |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/zen.webp" width="16" alt=""> | Zen | Gecko- same constraints as Firefox |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/floorp.webp" width="16" alt=""> | Floorp | Gecko- same constraints as Firefox |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/tor-browser.webp" width="16" alt=""> | Tor Browser | Gecko- same constraints as Firefox |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/mullvad-browser.webp" width="16" alt=""> | Mullvad Browser | Gecko- same constraints as Firefox |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/icecat.webp" width="16" alt=""> | IceCat | Gecko- same constraints as Firefox |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/safari.webp" width="16" alt="">  | Safari | WebKit (Apple desktop). Not Chromium |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/orion.webp" width="16" alt=""> | Orion | WebKit-based desktop browser. Not Chromium |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/chatgpt-atlas.webp" width="16" alt=""> | ChatGPT Atlas | AI-first browser, not in Glider’s supported Chromium + CWS model today |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/perplexity-comet.webp" width="16" alt=""> | Perplexity Comet | AI-first browser, not in Glider’s supported Chromium + CWS model today |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/bromite.webp" width="16" alt=""> | Bromite | Chromium-derived, no practical Chrome Web Store path for Glider |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/chromium.webp" width="16" alt=""> | Chromite | Chromium-derived, no practical Chrome Web Store path for Glider |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/grapheneos.webp" width="16" alt=""> | Vanadium | Chromium-derived (GrapheneOS), no practical Chrome Web Store path for Glider |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/duckduckgo.webp" width="16" alt=""> | DuckDuckGo | No practical Chrome Web Store extension install path for Glider |
+
+### Configuring the browser
+
+**Priority (highest first):** config file -> default `Google Chrome`
+
+#### Config file: `$HOME/.glider/config/browser.json`
+
+Use a **registry key** or explicit name/path in the file
+
+**Option A- Registry key (recommended):**
+
+Set browser by key from the browsers registry. Run `glider use <key>` to write this.
+
+```json
+{
+  "use": "arc"
+}
 ```
 
-### Requirements
+Registry is loaded from (first found): `$HOME/.cursor/registry/browsers.json`, `$HOME/.glider/config/browsers-registry.json`. Keys are predefined (e.g. `arc`, `brave`, `chrome`, `edge`, `opera`, `vivaldi`, `chromium`). Edit the registry to add or change paths
 
-1. **Node 18+**
+**Option B- Explicit name/path:**
 
-2. **Glider Chrome extension** - [Install from Chrome Web Store](https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj)
+| Field | Required | Description |
+|-------|:--------:|-------------|
+| `name` | Yes* | App name for `open -a` / AppleScript. Must match system (e.g. `Arc`, `Google Chrome`). |
+| `path` | No | If set, use `open "<path>"` instead of `open -a "<name>"`. For non-default install location. |
+| `processName` | No | For `pgrep -x`. Defaults to `name`. |
 
-## Usage
+\* Omit `name` when using `use` (registry key).
 
-```bash
-glider connect                   # connect to browser
-glider status                    # check connection
-glider goto "https://x.com"      # navigate
-glider eval "document.title"     # run JS
-glider run task.yaml             # execute task file
-glider loop task.yaml -n 50      # autonomous loop
+**Example:**
+
+```json
+{
+  "name": "Arc",
+  "path": "/Applications/Arc.app",
+  "processName": "Arc"
+}
 ```
 
-### Daemon
+**By browser:**
 
-The daemon keeps the relay server running 24/7. Auto-restarts on crash.
+| Browser | `name` | `path` (optional) | `processName` (optional) |
+|---------|--------|-------------------|---------------------------|
+| Arc | `Arc` | `/Applications/Arc.app` | `Arc` |
+| Edge | `Microsoft Edge` | n/a | `Microsoft Edge` |
+| Chrome (custom) | `Google Chrome` | `/Users/me/Applications/Google Chrome.app` | `Google Chrome` |
 
-```bash
-glider install     # install daemon (runs at login)
-glider uninstall   # remove daemon
+Check app name in Finder/Spotlight, process name: `ps aux | grep -i <name>`
+
+### Browser registry (keymap)
+
+A single registry file can define all Chromium browsers, Glider picks one by key
+
+**Registry location (first found):**
+
+- `$HOME/.cursor/registry/browsers.json`
+- `$HOME/.glider/config/browsers-registry.json`
+
+**Registry format:**
+
+```json
+{
+  "version": "1.0",
+  "registry": {
+    "arc": { "name": "Arc", "path": "/Applications/Arc.app", "processName": "Arc" },
+    "brave": { "name": "Brave Browser", "path": "/Applications/Brave Browser.app", "processName": "Brave Browser" },
+    "chrome": { "name": "Google Chrome", "path": "/Applications/Google Chrome.app", "processName": "Google Chrome" },
+    "edge": { "name": "Microsoft Edge", "path": "/Applications/Microsoft Edge.app", "processName": "Microsoft Edge" }
+  }
+}
 ```
 
-Logs: `~/.glider/daemon.log`
+**Commands:**
+
+| Command | Effect |
+|---------|--------|
+| `glider use arc` | Set `$HOME/.glider/config/browser.json` to `{ "use": "arc" }` (resolved from registry). |
+| `glider use brave` | Switch to Brave. |
+| `glider use` | Show current key and list of registry keys. |
+| `glider browser` | Show resolved name, path, processName (and `use` key if set). |
+
+Add or edit entries in the registry to match your machine (e.g. custom install paths). Keys are stable, point Glider at one by name.
+
+### Platform
+
+| Platform | Behavior |
+|----------|----------|
+| macOS | `open -a "<name>"` or `open "<path>"`, AppleScript for tab/window. `name` = exact app name |
+| Linux / Windows | Not fully implemented. Future: `path` may be executable. |
 
-## The loop
+### Browser summary
 
-The `loop` (or `ralph`) command runs your task repeatedly until:
-- Completion marker found (`LOOP_COMPLETE` or `DONE`)
-- Max iterations reached
-- Timeout hit
+| Topic | Detail |
+|-------|--------|
+| Supported | Chromium-based + Chrome Web Store extension (see table above). |
+| Not supported | See **Future** in this README. |
+| Configure | `$HOME/.glider/config/browser.json` (use key or name/path). Registry: `$HOME/.cursor/registry/browsers.json` or `$HOME/.glider/config/browsers-registry.json` |
+| Switch | `glider use <key>` (e.g. `glider use arc`, `glider use brave`). |
+| Path | Optional, use when app is not in default location |
+
+---
+
+## Usage
 
 ```bash
-glider loop scrape-feed.yaml -n 100 -t 3600
-glider ralph task.yaml  # same thing
+glider connect
+glider status
+glider goto "https://reddit.com"
+glider eval "document.title"
+glider run task.yaml
+glider loop task.yaml -n 50
 ```
 
-Safety: max iterations, timeout, exponential backoff on errors, state persistence.
+| Daemon | Logs |
+|--------|------|
+| `glider install` / `glider uninstall` | `~/.glider/daemon.log` |
+
+---
 
 ## Task files
 
 ```yaml
-name: "Get timeline"
+name: "Reddit"
 steps:
-  - goto: "https://x.com/home"
-  - wait: 3
-  - eval: "document.querySelectorAll('article').length"
-  - screenshot: "/tmp/timeline.png"
+ - goto: "https://reddit.com"
+ - wait: 2
+ - eval: "document.title"
+ - screenshot: "/tmp/out.png"
 ```
 
+---
+
 ## Commands
 
-### Setup
-| Command | What |
-|---------|------|
-| `glider install` | Install daemon (runs at login) |
+| Command | Description |
+|---------|-------------|
+| `glider install` | Install daemon (relay at login) |
 | `glider uninstall` | Remove daemon |
-| `glider update` | Update to latest version |
 | `glider connect` | Connect to browser |
-| `glider status` | Server/extension/tab status |
-| `glider test` | Run diagnostics |
-
-### Navigation
-| Command | What |
-|---------|------|
+| `glider status` | Server / extension / tabs |
+| `glider browser` | Show browser config (name, path) |
 | `glider goto <url>` | Navigate |
-| `glider eval <js>` | Execute JavaScript |
+| `glider eval <js>` | Run JS in page |
 | `glider click <sel>` | Click element |
 | `glider type <sel> <text>` | Type into input |
-| `glider screenshot` | Capture page |
-| `glider html <sel>` | Get element HTML |
-| `glider title` | Get page title |
-| `glider text` | Get page text |
-
-### Multi-tab
-| Command | What |
-|---------|------|
-| `glider fetch <url>` | Fetch URL with browser session (authenticated) |
-| `glider spawn <urls...>` | Open multiple tabs |
-| `glider extract [opts]` | Extract content from all connected tabs |
-| `glider explore <url>` | Crawl site, capture links/network |
-
-### Automation
-| Command | What |
-|---------|------|
+| `glider screenshot [path]` | Capture page |
 | `glider run <file>` | Run YAML task |
-| `glider loop <file>` | Autonomous loop |
-| `glider ralph <file>` | Alias for loop |
+| `glider loop <file> [-n N]` | Loop until done or limit |
+
+Full list: `glider --help`
+
+---
+
+## Docs
+
+| Doc | Contents |
+|-----|----------|
+| This README | Install, usage, commands, full browser support/config |
+| [config/browser.json.example](config/browser.json.example) | Example browser config |
+
+---
 
 ## Roadmap
 
-- [x] CDP-based browser control via relay
-- [x] YAML task file execution
-- [x] Ralph Wiggum autonomous loop pattern
-- [x] Daemon mode (auto-start, auto-restart)
-- [x] macOS notifications
-- [x] Multi-tab orchestration (spawn, extract)
-- [x] Authenticated fetch via browser session
-- [x] Site exploration/crawling
-- [x] Chrome Web Store extension publish
-- [ ] Linux support
-- [ ] Windows support
-- [ ] Headless mode
-- [ ] Task chaining (output of one -> input of next)
-- [ ] Built-in scraping templates
-- [ ] Session recording/playback
-- [ ] AI-assisted task generation
-- [ ] Web dashboard for monitoring loops
-
-## Tools
-
-[![Claude Code][claudecode-badge]][claudecode-url]
-[![Claude][claude-badge]][claude-url]
-[![Node.js][nodejs-badge]][nodejs-url]
-[![Chrome DevTools Protocol][cdp-badge]][cdp-url]
+| Status | Area |
+|--------|------|
+| Done | CDP relay + extension, YAML tasks, loop, daemon, multi-tab |
+| Todo | Linux / Windows, headless, task chaining, scraping templates |
 
-## Contact
+---
 
+## Contact
 
-<a href="https://vd7.io"><img src="https://img.shields.io/badge/website-000000?style=for-the-badge&logo=data:image/webp;base64,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&logoColor=white" alt="website" /></a>
-<a href="https://x.com/vdutts7"><img src="https://img.shields.io/badge/vdutts7-000000?style=for-the-badge&logo=X&logoColor=white" alt="Twitter" /></a>
+<a href="https://vd7.io"><img src="https://res.cloudinary.com/ddyc1es5v/image/upload/v1773910810/readme-badges/readme-badge-vd7.png" alt="vd7.io" height="40" /></a> &nbsp; <a href="https://x.com/vdutts7"><img src="https://res.cloudinary.com/ddyc1es5v/image/upload/v1773910817/readme-badges/readme-badge-x.png" alt="/vdutts7" height="40" /></a>
 
 
 <!-- BADGES -->
@@ -189,15 +277,3 @@ steps:
 [github-url]: https://github.com/vdutts7/glidercli
 [npm]: https://img.shields.io/badge/npm%20i%20--g%20glidercli-CB3837?style=for-the-badge&logo=npm
 [npm-url]: https://www.npmjs.com/package/glidercli
-[claudecode-badge]: https://img.shields.io/badge/Claude_Code-D97757?style=for-the-badge&logo=anthropic&logoColor=white
-[claudecode-url]: https://claude.ai/code
-[claude-badge]: https://img.shields.io/badge/Claude-D97757?style=for-the-badge&logo=anthropic&logoColor=white
-[claude-url]: https://claude.ai
-[nodejs-badge]: https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white
-[nodejs-url]: https://nodejs.org
-[cdp-badge]: https://img.shields.io/badge/Chrome_DevTools_Protocol-4285F4?style=for-the-badge&logo=googlechrome&logoColor=white
-[cdp-url]: https://chromedevtools.github.io/devtools-protocol/
-[email]: https://img.shields.io/badge/Email-000000?style=for-the-badge&logo=Gmail&logoColor=white
-[email-url]: mailto:me@vd7.io
-[twitter]: https://img.shields.io/badge/Twitter-000000?style=for-the-badge&logo=Twitter&logoColor=white
-[twitter-url]: https://x.com/vdutts7

package/bin/glider.js

@@ -50,11 +50,10 @@ if (fs.existsSync(REGISTRY_FILE)) {
 // Direct CDP module
 const { DirectCDP, checkChrome } = require(path.join(LIB_DIR, 'cdp-direct.js'));
 
-// Domain extensions - load from ~/.glider/config/domains.json (primary) or legacy paths
+// Domain extensions - load from ~/.glider/config/domains.json
 const DOMAIN_CONFIG_PATHS = [
   path.join(os.homedir(), '.glider', 'config', 'domains.json'),
   path.join(os.homedir(), '.glider', 'domains.json'),
-  path.join(os.homedir(), '.cursor', 'glider', 'domains.json'), // legacy
 ];
 let DOMAINS = {};
 for (const cfgPath of DOMAIN_CONFIG_PATHS) {
@@ -66,6 +65,55 @@ for (const cfgPath of DOMAIN_CONFIG_PATHS) {
   }
 }
 
+// Browser config - which browser to launch/use (must be Chromium-based, see docs/BROWSERS.md)
+const BROWSER_CONFIG_PATHS = [
+  path.join(os.homedir(), '.glider', 'config', 'browser.json'),
+  path.join(os.homedir(), '.glider', 'browser.json'),
+];
+let BROWSER_CONFIG = {};
+for (const cfgPath of BROWSER_CONFIG_PATHS) {
+  if (fs.existsSync(cfgPath)) {
+    try {
+      BROWSER_CONFIG = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+      break;
+    } catch (e) { /* ignore parse errors */ }
+  }
+}
+
+// Browsers registry - key → { name, path, processName }. Used when browser.json has "use": "<key>"
+const BROWSERS_REGISTRY_PATHS = [
+  path.join(os.homedir(), '.cursor', 'registry', 'browsers.json'),
+  path.join(os.homedir(), '.glider', 'config', 'browsers-registry.json'),
+].filter(Boolean);
+let BROWSERS_REGISTRY = {};
+for (const regPath of BROWSERS_REGISTRY_PATHS) {
+  if (regPath && fs.existsSync(regPath)) {
+    try {
+      const data = JSON.parse(fs.readFileSync(regPath, 'utf8'));
+      BROWSERS_REGISTRY = data.registry || data;
+      break;
+    } catch (e) { /* ignore */ }
+  }
+}
+
+function getBrowserConfig() {
+  let name = BROWSER_CONFIG.name || null;
+  let pathOrNull = BROWSER_CONFIG.path || null;
+  let processName = BROWSER_CONFIG.processName || null;
+
+  // Key-based lookup: browser.json has { "use": "arc" } → resolve from registry
+  if (!name && BROWSER_CONFIG.use && BROWSERS_REGISTRY[BROWSER_CONFIG.use]) {
+    const entry = BROWSERS_REGISTRY[BROWSER_CONFIG.use];
+    name = entry.name;
+    pathOrNull = entry.path != null ? entry.path : null;
+    processName = entry.processName || entry.name;
+  }
+
+  name = name || 'Google Chrome';
+  processName = processName || name;
+  return { name, path: pathOrNull, processName };
+}
+
 // Colors - matching the deep blue gradient logo
 const RED = '\x1b[31m';
 const GREEN = '\x1b[32m';
@@ -242,7 +290,7 @@ async function ensureConnected() {
   
   if (!await checkExtension()) {
     log.fail('Extension not connected - make sure Glider extension is installed');
-    log.info('Install from: chrome://extensions → Load unpacked → ~/glider-crx/glider/');
+    log.info('Install extension from Chrome Web Store: https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj');
     return false;
   }
   
@@ -621,7 +669,7 @@ async function cmdUninstallDaemon() {
 }
 
 async function cmdConnect() {
-  // Bulletproof connect: relay + Chrome + trigger attach via HTTP
+  // Bulletproof connect: relay + browser + trigger attach via HTTP
   log.info('Connecting...');
   
   // 1. Ensure relay is running
@@ -630,12 +678,17 @@ async function cmdConnect() {
     await new Promise(r => setTimeout(r, 1000));
   }
   
-  // 2. Ensure Chrome is running
+  // 2. Ensure browser is running (see getBrowserConfig + docs/BROWSERS.md)
+  const browser = getBrowserConfig();
   try {
-    execSync('pgrep -x "Google Chrome"', { stdio: 'ignore' });
+    execSync(`pgrep -x "${browser.processName}"`, { stdio: 'ignore' });
   } catch {
-    log.info('Starting Chrome...');
-    execSync('open -a "Google Chrome"');
+    log.info(`Starting ${browser.name}...`);
+    if (browser.path) {
+      execSync(`open "${browser.path}"`, { stdio: 'ignore' });
+    } else {
+      execSync(`open -a "${browser.name}"`);
+    }
     await new Promise(r => setTimeout(r, 3000));
   }
   
@@ -647,7 +700,7 @@ async function cmdConnect() {
   
   if (!await checkExtension()) {
     log.fail('Extension not connected to relay');
-    log.info('Make sure Glider extension is installed in Chrome');
+    log.info(`Make sure Glider extension is installed in ${browser.name} (Chromium-based only; see glider docs/BROWSERS.md)`);
     process.exit(1);
   }
   log.ok('Extension connected');
@@ -665,18 +718,18 @@ async function cmdConnect() {
     return;
   }
   
-  // 5. Ensure we have a real tab (not chrome://)
+  // 5. Ensure we have a real tab (not chrome:// or arc://)
   try {
-    const tabUrl = execSync(`osascript -e 'tell application "Google Chrome" to return URL of active tab of front window'`).toString().trim();
-    if (tabUrl.startsWith('chrome://') || tabUrl.startsWith('chrome-extension://')) {
+    const tabUrl = execSync(`osascript -e 'tell application "${browser.name}" to return URL of active tab of front window'`).toString().trim();
+    if (tabUrl.startsWith('chrome://') || tabUrl.startsWith('chrome-extension://') || tabUrl.startsWith('arc://')) {
       log.info('Creating new tab...');
-      execSync(`osascript -e 'tell application "Google Chrome" to make new tab at front window with properties {URL:"https://google.com"}'`);
+      execSync(`osascript -e 'tell application "${browser.name}" to make new tab at front window with properties {URL:"https://google.com"}'`);
       await new Promise(r => setTimeout(r, 2000));
     }
   } catch {
     // No window, create one
     log.info('Creating new window...');
-    execSync(`osascript -e 'tell application "Google Chrome" to make new window with properties {URL:"https://google.com"}'`);
+    execSync(`osascript -e 'tell application "${browser.name}" to make new window with properties {URL:"https://google.com"}'`);
     await new Promise(r => setTimeout(r, 2000));
   }
   
@@ -700,7 +753,7 @@ async function cmdConnect() {
   
   // 7. Fallback: create fresh tab and retry
   log.info('Creating fresh tab...');
-  execSync(`osascript -e 'tell application "Google Chrome" to make new tab at front window with properties {URL:"https://google.com"}'`);
+  execSync(`osascript -e 'tell application "${browser.name}" to make new tab at front window with properties {URL:"https://google.com"}'`);
   await new Promise(r => setTimeout(r, 2000));
   
   try {
@@ -717,13 +770,13 @@ async function cmdConnect() {
     }
   } catch {}
   
-  // 8. Need manual click - open Chrome and show instructions
-  log.warn('Click the Glider extension icon in Chrome');
-  console.log(`  ${B5}(on any real webpage, not chrome:// pages)${NC}`);
-  execSync(`osascript -e 'tell application "Google Chrome" to activate'`);
+  // 8. Need manual click - activate browser and show instructions
+  log.warn(`Click the Glider extension icon in ${browser.name}`);
+  console.log(`  ${B5}(on any real webpage, not chrome:// or arc:// pages)${NC}`);
+  execSync(`osascript -e 'tell application "${browser.name}" to activate'`);
   
   // Send macOS notification so user sees it even if not looking at terminal
-  notify('Glider', 'Click the extension icon in Chrome to connect', true);
+  notify('Glider', `Click the extension icon in ${browser.name} to connect`, true);
   
   // Wait for user to click
   log.info('Waiting for connection...');
@@ -745,6 +798,40 @@ async function cmdConnect() {
   log.info('Make sure you clicked the extension icon on a real webpage');
 }
 
+function cmdBrowser() {
+  const b = getBrowserConfig();
+  console.log('Browser config (used by glider connect):');
+  console.log(`  name:         ${b.name}`);
+  console.log(`  path:         ${b.path || '(default launch via name)'}`);
+  console.log(`  processName:  ${b.processName}`);
+  if (BROWSER_CONFIG.use) {
+    console.log(`  use:          ${BROWSER_CONFIG.use} ${DIM}(from registry)${NC}`);
+  }
+  console.log('');
+  console.log('Source: ~/.glider/config/browser.json { "use": "<key>" } or { name, path } → default "Google Chrome"');
+  console.log('Registry: ~/.cursor/registry/browsers.json or ~/.glider/config/browsers-registry.json. Keys: ' + (Object.keys(BROWSERS_REGISTRY).join(', ') || '(none loaded)'));
+  console.log('See README.md#browsers for compatibility and examples.');
+}
+
+function cmdUse(key) {
+  if (!key) {
+    console.log('Usage: glider use <key>');
+    console.log('Keys in registry: ' + (Object.keys(BROWSERS_REGISTRY).length ? Object.keys(BROWSERS_REGISTRY).join(', ') : '(no registry loaded)'));
+    if (BROWSER_CONFIG.use) console.log('Current: ' + BROWSER_CONFIG.use);
+    return;
+  }
+  if (!BROWSERS_REGISTRY[key]) {
+    console.error('Unknown key: ' + key + '. Available: ' + Object.keys(BROWSERS_REGISTRY).join(', '));
+    process.exit(1);
+  }
+  const configDir = path.join(os.homedir(), '.glider', 'config');
+  const browserPath = path.join(configDir, 'browser.json');
+  if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true });
+  fs.writeFileSync(browserPath, JSON.stringify({ use: key }, null, 2) + '\n');
+  console.log('Set browser to: ' + key + ' → ' + BROWSERS_REGISTRY[key].name);
+  console.log('Run: glider connect');
+}
+
 async function cmdTest() {
   showBanner();
   log.box('DIAGNOSTICS');
@@ -1342,11 +1429,13 @@ async function cmdExplore(url, opts = []) {
   let depth = 2;
   let outputDir = '/tmp/glider-explore';
   let harFile = null;
+  let sessionId = null;
   
   for (let i = 0; i < opts.length; i++) {
     if (opts[i] === '--depth' || opts[i] === '-d') depth = parseInt(opts[++i], 10);
     else if (opts[i] === '--output' || opts[i] === '-o') outputDir = opts[++i];
     else if (opts[i] === '--har') harFile = opts[++i];
+    else if (opts[i] === '--session-id') sessionId = opts[++i];
   }
   
   log.info(`Exploring: ${url} (depth: ${depth})`);
@@ -1357,6 +1446,7 @@ async function cmdExplore(url, opts = []) {
     const { spawn } = require('child_process');
     const spawnArgs = [bexplorePath, url, '--depth', String(depth), '--output', outputDir];
     if (harFile) spawnArgs.push('--har', harFile);
+    if (sessionId) spawnArgs.push('--session-id', sessionId);
     
     const child = spawn('node', spawnArgs, {
       stdio: 'inherit'
@@ -1659,6 +1749,8 @@ ${B5}SETUP${NC}
 
 ${B5}STATUS${NC}
     ${BW}status${NC}              Check server, extension, tabs
+    ${BW}browser${NC}             Show browser config ${DIM}(name, path, processName, or use key)${NC}
+    ${BW}use${NC} <key>           Set browser by registry key ${DIM}(e.g. arc, brave, chrome)${NC}
     ${BW}test${NC}                Run diagnostics
 
 ${B5}NAVIGATION${NC}
@@ -1755,7 +1847,7 @@ ${YELLOW}DOMAIN EXTENSIONS:${NC}
     Add custom domain commands via ~/.glider/config/domains.json:
     {
       "mysite": { "url": "https://mysite.com/dashboard" },
-      "mytool": { "script": "~/.cursor/tools/scripts/mytool.sh" }
+      "mytool": { "script": "~/scripts/mytool.sh" }
     }
     Then: glider mysite  ->  navigates to that URL
           glider mytool  ->  runs that script
@@ -1887,6 +1979,12 @@ async function main() {
     case 'connect':
       await cmdConnect();
       break;
+    case 'browser':
+      cmdBrowser();
+      break;
+    case 'use':
+      cmdUse(args[1]);
+      break;
     case 'test':
       await cmdTest();
       break;

package/config/browser.json.example

@@ -0,0 +1,5 @@
+{
+  "name": "Arc",
+  "path": "/Applications/Arc.app",
+  "processName": "Arc"
+}

package/docs/BROWSERS.md

@@ -0,0 +1,7 @@
+# Browser docs moved
+
+Browser support and configuration now live in the main README:
+
+- [README `## Browsers`](../README.md#browsers)
+
+Reason: npmjs displays README prominently; putting browser setup there makes it much easier for users to find.

package/docs/setup.json

@@ -0,0 +1,40 @@
+{
+  "meta": {
+    "project": "glidercli",
+    "updated": "2026-01-31"
+  },
+  "architecture": {
+    "flow": "glidercli -> bserve (ws:19988) -> chrome-extension -> chrome.debugger -> tab",
+    "relay_port": 19988,
+    "relay_host": "127.0.0.1"
+  },
+  "requirements": {
+    "node": ">=18",
+    "browser": "Chromium-based (Chrome, Arc, Edge, Brave, etc.); see README Browsers section",
+    "os": "macOS (tested), Linux (untested), Windows (untested)"
+  },
+  "install": {
+    "cli": "npm install -g glidercli",
+    "extension": {
+      "cws": "https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj",
+      "source": "https://github.com/vdutts7/glider"
+    }
+  },
+  "endpoints": {
+    "http": {
+      "/status": "GET - extension/targets/clients status",
+      "/targets": "GET - connected tabs",
+      "/cdp": "POST - forward CDP command"
+    },
+    "websocket": {
+      "/extension": "chrome extension connects here",
+      "/cdp": "cli/clients connect here"
+    }
+  },
+  "config_paths": {
+    "domains": "~/.glider/config/domains.json",
+    "browser": "~/.glider/config/browser.json",
+    "daemon_log": "~/.glider/daemon.log"
+  },
+  "discovery": "glider --help"
+}

package/lib/bexplore.js

@@ -27,6 +27,8 @@ class SiteExplorer {
     this.depth = options.depth || 3;
     this.outputDir = options.outputDir || '/tmp/explore';
     this.harFile = options.harFile;
+    this.wantedSessionId = options.sessionId || null;
+    this.sessionResolved = null;
     
     // Captured data
     this.requests = [];
@@ -77,8 +79,15 @@ class SiteExplorer {
     }
     
     if (msg.method === 'Target.attachedToTarget') {
-      if (!this.sessionId) {
-        this.sessionId = msg.params.sessionId;
+      const sid = msg.params.sessionId;
+      if (this.wantedSessionId) {
+        if (sid === this.wantedSessionId) {
+          this.sessionId = sid;
+          if (this.sessionResolved) this.sessionResolved();
+        }
+      } else if (!this.sessionId) {
+        this.sessionId = sid;
+        if (this.sessionResolved) this.sessionResolved();
       }
     }
     
@@ -179,7 +188,13 @@ class SiteExplorer {
 
   async init() {
     await this.send('Target.setAutoAttach', { autoAttach: true, waitForDebuggerOnStart: false, flatten: true });
-    await new Promise(r => setTimeout(r, 500));
+    await new Promise((resolve, reject) => {
+      this.sessionResolved = resolve;
+      setTimeout(() => {
+        if (!this.sessionId) reject(new Error('Timeout waiting for tab attachment'));
+        else resolve();
+      }, 10000);
+    });
     if (!this.sessionId) throw new Error('No browser tab connected');
     
     // Enable ALL the things
@@ -756,14 +771,16 @@ Examples:
   let depth = 3;
   let outputDir = '/tmp/explore';
   let harFile = null;
+  let sessionId = null;
   
   for (let i = 0; i < args.length; i++) {
     if (args[i] === '--depth') depth = parseInt(args[++i]);
     else if (args[i] === '--output') outputDir = args[++i];
     else if (args[i] === '--har') harFile = args[++i];
+    else if (args[i] === '--session-id') sessionId = args[++i];
   }
   
-  const explorer = new SiteExplorer({ depth, outputDir, harFile });
+  const explorer = new SiteExplorer({ depth, outputDir, harFile, sessionId });
   
   try {
     await explorer.connect();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glidercli",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Browser automation CLI. Control Chrome from terminal via CDP, run YAML task files, autonomous loops until completion.",
   "main": "index.js",
   "bin": {
@@ -37,6 +37,8 @@
   "files": [
     "bin/",
     "lib/",
+    "docs/",
+    "config/",
     "index.js",
     "README.md"
   ]