glidercli 0.3.5 → 0.3.6

package/README.md

@@ -15,173 +15,110 @@
 
 <br/>
 
-## ToC
-
-<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>
-
-<br/>
-
 ## About
 
-Control Chrome from terminal. Run YAML tasks. Loop until complete (Ralph Wiggum pattern).
+| | |
+|---|---|
+| **What** | Control a Chromium-based browser from the terminal via CDP; run YAML tasks; 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 |
 
-- **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
 
-**One-liner:**
-```bash
-npm i -g glidercli && open "https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj"
-```
+| Step | Action |
+|------|--------|
+| **1. CLI** | `npm i -g glidercli` |
+| **2. Extension** | [Install Glider from Chrome Web Store](https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj) (required; bridges relay ↔ tab). |
+| **3. Daemon** | `glider install` then `glider connect` |
+| **4. (Optional) Browser** | Default: Chrome. For Arc/Edge/Brave: [BROWSERS.md](docs/BROWSERS.md) or `export GLIDER_BROWSER=Arc` |
 
-**Then:**
-```bash
-glider install    # start daemon (runs forever, auto-restarts)
-glider connect    # connect to Chrome
-```
 
-**Update anytime:**
-```bash
-glider update     # pulls latest from npm
-```
-
-### Requirements
+## Requirements
 
-1. **Node 18+**
+| Requirement | Minimum |
+|-------------|---------|
+| Node | 18+ |
+| Browser | Chromium-based (Chrome, Arc, Edge, Brave, Opera, Vivaldi, DuckDuckGo). No Firefox/Safari → [BROWSERS.md](docs/BROWSERS.md) |
 
-2. **Glider Chrome extension** - [Install from Chrome Web Store](https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj)
+---
 
 ## Usage
 
 ```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
-```
-
-### Daemon
-
-The daemon keeps the relay server running 24/7. Auto-restarts on crash.
-
-```bash
-glider install     # install daemon (runs at login)
-glider uninstall   # remove daemon
+glider connect
+glider status
+glider goto "https://reddit.com"
+glider eval "document.title"
+glider run task.yaml
+glider loop task.yaml -n 50
 ```
 
-Logs: `~/.glider/daemon.log`
+| Daemon | Logs |
+|--------|------|
+| `glider install` / `glider uninstall` | `~/.glider/daemon.log` |
 
-## The loop
-
-The `loop` (or `ralph`) command runs your task repeatedly until:
-- Completion marker found (`LOOP_COMPLETE` or `DONE`)
-- Max iterations reached
-- Timeout hit
-
-```bash
-glider loop scrape-feed.yaml -n 100 -t 3600
-glider ralph task.yaml  # same thing
-```
-
-Safety: max iterations, timeout, exponential backoff on errors, state persistence.
+---
 
 ## 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 |
+| [docs/BROWSERS.md](docs/BROWSERS.md) | Which browsers work; browser name/path (env or `~/.glider/config/browser.json`) |
+| [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,UklGRjAGAABXRUJQVlA4TCQGAAAvP8APEAHFbdtGsOVnuv/A6T1BRP8nQE8zgZUy0U4ktpT4QOHIJzqqDwxnbIyyAzADbAegMbO2BwratpHMH/f+OwChqG0jKXPuPsMf2cJYCP2fAMQe4OKTZIPEb9mq+y3dISZBN7Jt1bYz5rqfxQwWeRiBbEWgABQfm9+UrxiYWfLw3rtn1Tlrrb3vJxtyJEmKJM+lYyb9hbv3Mt91zj8l2rZN21WPbdu2bdsp2XZSsm3btm3bybfNZ+M4lGylbi55EIQLTcH2GyAFeHDJJ6+z//uviigx/hUxuTSVzqSMIdERGfypiZ8OfPnU1reQeKfxvhl8r/V5oj3VzJQ3qbo6RLh4BjevcBE+30F8eL/GcWI01ddkE1IFhmAAA+xPQATifcTO08J+CL8z+OBpEw+zTGuTYteMrhTDAPtVhCg2X5lYDf9fjg+fl/GwkupiUhBSBUUFLukjJFpD/C8W/rWR5kLYlB8/mGzmOzIKyTK5A4MCjKxAv2celbsItx/lUrRTZAT5NITMV3iL0cUAAGI0MRF2rONYBRRlhICQubO1P42kGC7AOMTWV7fSrEKRQ5UzsJ/5UtXWKy9tca6iP5FmDQeCiFQBQQgUfsEAQl1LLLWCAWAAISL17ySvICqUShDAZHV6MYyScQAIggh7j/g5/uevIHzz6A6FXI0LgdJ4g2oCAUFQfQfJM7xvKvGtsMle79ylhLsUx/QChEAQHCaezHD76fSAICgIIGuTJaMbIJfSfAEBCME/V4bnPa5yLoiOEEEoqx1JqrZ/SK1nZApxF/7sAF8r7oD03CorvVesxRAIgits66BaKWyy4FJCctC0e7eAiFef7dytgLviriDkS6lXWHOsDZgeDUEAwYJKeIXpIsiXGUNeEfb1Nk+yZIPrHpwvEDs3C0EhuwhgmdQoBKOAqpjAjMn41PQiVGG3CDlwCc0AGXX8s0Eshc8JPGkNhGJeDexYOudRdiX4+p2tGTvgothaMJs7wchxk9CBMoLZPQhGdIZgA4yGL7JvvhkpYK3xOq86xYIZAd9sCBqJZAA2ln5ldu8CSwEDRRFgF+wEAEKoZoW/8jY05bE3ds2f4uA5DAMAiNIBAYDGXDL0O78AjKlWRg+Y/9/eyL0tKIoUaxtIyKDUFQKgtJZKPmBAMgvZIQKAIJcQKFqGQjf2FELTAy6TnzADZLsnisNPABAZhU1LB6FpugmnUJ0oNedA3QPPVR6+AiBIXbgIAgDCdO7axjeEpLnk9k2nkKgPQ3zV5vvWrkx/wcrcpFT75QrBBibCq1aolkensxvZsN/0L2KDh79aTehXhPnoTggpBgiY+J8PIjdcmfpBofGokzMNMJY619i/AvEH2DD+fNlqCfVUcBEINS0FGPVuNPkE1+cdY+ebIKJqXQhBMBZMAkj7Xn91vN0BCfAC5J5PyHm71ptJJm3m7lCPUiHBTdBdCJlk0gAGEJroomQTxF2feZ4wJi4Y+9FqQoO1/ceoCoC7IOGtpU/m446s5TwXPTQxLgCcOZEBATG1zlfbeUJGcehbv9m6IPzaxLVSxGCPiEg7ThvWYPFehhc2gAIIEdsFob9Nx19YnR0Tf6IcqHIaVhDhhHbHFJa9p6Pj2gJjGsBfZrEAwNQ02UHAyuYLIeNPefgbNPL12lp4n/9uTSKERl3bwKmpAHSAuBODTNzk/1qXSqj2GljiqMsvr50CvcCbM5OSraOuTMJq28Fv48+waTWvrqQ0+8tIC0LxCFzgDAyIOdFqoZbPSUvkL9yB5JFDW682QhBpGAqAFfn7R2pV2u5zBoqlzpHRt78hXCETWJPjVHDiPJit5GQLYmJMNFiVr1bSnGOlCXIdkyyFpcHgtzH0BusCiQzPRUifr61BoW5aAvHxyI/gIjnOPB6chcCYHsJuEQogBM689OtvcKFAytNEB/N26qXQvQITd2a3ruZCMrgUcBVqvLiS6lR9Bi8gaNBrJtIc/GdYDj+AOyQPV61D9BfdguJCft31hHjzyBz7dzgOIeAOymsrKb59V+FKtYyqa6pGlIrKpEiRvk3zt+sL4jX1+G/uQii4C/LBSsp3n2V/NHIchtQAeC7K9/6DGHAPCwA=&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 +126,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,56 @@ 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 = [
+  process.env.GLIDER_BROWSERS_REGISTRY,
+  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 = process.env.GLIDER_BROWSER || BROWSER_CONFIG.name;
+  let pathOrNull = process.env.GLIDER_BROWSER_PATH || BROWSER_CONFIG.path || null;
+  let processName = process.env.GLIDER_BROWSER_PROCESS || BROWSER_CONFIG.processName;
+
+  // 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 +291,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 +670,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 +679,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 +701,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 +719,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 +754,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 +771,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 +799,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_BROWSER* env → ~/.glider/config/browser.json { "use": "<key>" } or { name, path } → default "Google Chrome"');
+  console.log('Registry: GLIDER_BROWSERS_REGISTRY or ~/.cursor/registry/browsers.json. Keys: ' + Object.keys(BROWSERS_REGISTRY).join(', ') || '(none loaded)');
+  console.log('See docs/BROWSERS.md 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 +1430,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 +1447,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 +1750,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 +1848,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 +1980,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,185 @@
+# Glider browser support and configuration
+
+| | |
+|---|---|
+| **Install / usage** | [README](../README.md) |
+| **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 — same for every browser in this table.
+
+| | 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 | `GLIDER_BROWSER=Arc` or [browser.json](../config/browser.json.example). |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/microsoft/microsoft-edge.webp" width="16" alt=""> | Microsoft Edge | — |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/brave.webp" width="16" alt=""> | Brave | — |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/opera-gx.webp" width="16" alt=""> | Opera | — |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/vivaldi.webp" width="16" alt=""> | Vivaldi | — |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/duckduckgo.webp" width="16" alt=""> | DuckDuckGo Desktop | — |
+| <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. |
+
+See **[Future](#future)** for browsers not supported today.
+
+---
+
+## 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.
+
+Same icon base as above: `https://raw.githubusercontent.com/vdutts7/squircle/main/webp/{slug}.webp`.
+
+| | 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/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/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/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. |
+
+---
+
+## Configuring the browser
+
+**Priority (highest first):** env vars → config file → default `Google Chrome`.
+
+### Environment variables
+
+| Variable | Purpose | Example |
+|----------|---------|---------|
+| `GLIDER_BROWSER` | App name (`open -a`, AppleScript) | `Arc`, `Google Chrome`, `Microsoft Edge` |
+| `GLIDER_BROWSER_PATH` | (Optional) Path to app bundle | `/Applications/My Apps/Chrome.app` |
+| `GLIDER_BROWSER_PROCESS` | (Optional) Process name for `pgrep` | Defaults to same as `GLIDER_BROWSER` |
+
+**Examples:**
+
+| Use case | Command |
+|----------|---------|
+| Arc | `export GLIDER_BROWSER=Arc` then `glider connect` |
+| Custom Chrome path | `export GLIDER_BROWSER="Google Chrome"` and `export GLIDER_BROWSER_PATH="/Applications/My Apps/Google Chrome.app"` |
+
+### Config file: `$HOME/.glider/config/browser.json`
+
+Same keys as env, or use a **registry key**. Env overrides file.
+
+**Option A — Registry key (recommended):**
+
+Set browser by key from the browsers registry. Run `glider use <key>` to write this.
+
+```json
+{
+  "use": "arc"
+}
+```
+
+Registry is loaded from (first found): `GLIDER_BROWSERS_REGISTRY` env, `$HOME/.cursor/registry/browsers.json`, `$HOME/.glider/config/browsers-registry.json`. Keys are predefined (e.g. `arc`, `brave`, `chrome`, `edge`, `opera`, `vivaldi`, `duckduckgo`, `chromium`). Edit the registry to add or change paths.
+
+**Option B — Explicit name/path:**
+
+| 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`. |
+
+\* Omit `name` when using `use` (registry key).
+
+**Example:**
+
+```json
+{
+  "name": "Arc",
+  "path": "/Applications/Arc.app",
+  "processName": "Arc"
+}
+```
+
+**By browser:**
+
+| Browser | `name` | `path` (optional) | `processName` (optional) |
+|---------|--------|-------------------|---------------------------|
+| Arc | `Arc` | `/Applications/Arc.app` | `Arc` |
+| Edge | `Microsoft Edge` | — | `Microsoft Edge` |
+| Chrome (custom) | `Google Chrome` | `/Users/me/Applications/Google Chrome.app` | `Google Chrome` |
+| DuckDuckGo | `DuckDuckGo` | — | `DuckDuckGo` |
+
+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):**
+
+- `GLIDER_BROWSERS_REGISTRY` (env, path to JSON file)
+- `$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" }
+  }
+}
+```
+
+**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. |
+
+---
+
+## Summary
+
+| Topic | Detail |
+|-------|--------|
+| Supported | Chromium-based + Chrome Web Store extension (see table above). |
+| Not supported | See [Future](#future). |
+| Configure | `$HOME/.glider/config/browser.json` (use key or name/path) and/or `GLIDER_BROWSER*`. Registry: `$HOME/.cursor/registry/browsers.json` or `GLIDER_BROWSERS_REGISTRY`. |
+| Switch | `glider use <key>` (e.g. `glider use arc`, `glider use brave`). |
+| Path | Optional; use when app is not in default location. |
+
+---
+
+[← README](../README.md)

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 docs/BROWSERS.md",
+    "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.6",
   "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"
   ]