npm - glidercli - Versions diffs - 0.3.6 → 0.3.8 - Mend

glidercli 0.3.6 → 0.3.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md CHANGED Viewed

@@ -1,15 +1,14 @@
 <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]
+<a href="https://github.com/vdutts7/glidercli"><img src="./assets/badges/github.badge.svg" alt="GitHub" height="34" /></a> &nbsp; <a href="https://www.npmjs.com/package/glidercli"><img src="./assets/badges/npm.badge.svg" alt="npm install" height="34" /></a>
 </div>
@@ -19,7 +18,7 @@
 | | |
 |---|---|
-| **What** | Control a Chromium-based browser from the terminal via CDP; run YAML tasks; loop until done (Ralph Wiggum pattern). |
+| **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 |
@@ -32,9 +31,9 @@
 | 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). |
+| **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. (Optional) Browser** | Default: Chrome. For Arc/Edge/Brave: [BROWSERS.md](docs/BROWSERS.md) or `export GLIDER_BROWSER=Arc` |
+| **4. Browser (required setup)** | Configure supported browser/profile + extension in the **Browsers** section below. |
 ## Requirements
@@ -42,7 +41,158 @@
 | Requirement | Minimum |
 |-------------|---------|
 | Node | 18+ |
-| Browser | Chromium-based (Chrome, Arc, Edge, Brave, Opera, Vivaldi, DuckDuckGo). No Firefox/Safari → [BROWSERS.md](docs/BROWSERS.md) |
+| Browser | Chromium-based (Chrome, Arc, Edge, Brave, Opera, Vivaldi) with the Glider extension installed/enabled in that browser profile. No Firefox/Safari/DuckDuckGo |
+---
+## Browsers
+| | |
+|---|---|
+| **How it works** | Chrome extension → WebSocket relay → CDP. Browser must support that extension (Chromium-based). |
+### Browser support
+**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/operagx.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"
+}
+```
+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
+**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` | n/a | `Microsoft Edge` |
+| Chrome (custom) | `Google Chrome` | `/Users/me/Applications/Google Chrome.app` | `Google Chrome` |
+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" }
+  }
+}
+```
+**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. |
+### Browser summary
+| 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 |
 ---
@@ -68,10 +218,10 @@ glider loop task.yaml -n 50
 ```yaml
 name: "Reddit"
 steps:
-  - goto: "https://reddit.com"
-  - wait: 2
-  - eval: "document.title"
-  - screenshot: "/tmp/out.png"
+ - goto: "https://reddit.com"
+ - wait: 2
+ - eval: "document.title"
+ - screenshot: "/tmp/out.png"
 ```
 ---
@@ -93,7 +243,7 @@ steps:
 | `glider run <file>` | Run YAML task |
 | `glider loop <file> [-n N]` | Loop until done or limit |
-Full list: `glider --help`.
+Full list: `glider --help`
 ---
@@ -101,28 +251,21 @@ Full list: `glider --help`.
 | 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`) |
+| This README | Install, usage, commands, full browser support/config |
 | [config/browser.json.example](config/browser.json.example) | Example browser config |
 ---
 ## Roadmap
-| Status | Area |
-|--------|------|
-| Done | CDP relay + extension, YAML tasks, loop, daemon, multi-tab |
-| Todo | Linux / Windows, headless, task chaining, scraping templates |
+- [x] CDP relay + extension, YAML tasks, loop, daemon, multi-tab
+- [ ] Linux / Windows
+- [ ] headless (cloud)
+- [ ] task chaining
+- [ ] crawling templates
 ---
 ## Contact
 <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 -->
-[github]: https://img.shields.io/badge/glidercli-000000?style=for-the-badge&logo=github
-[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

package/bin/glider.js CHANGED Viewed

@@ -65,7 +65,7 @@ for (const cfgPath of DOMAIN_CONFIG_PATHS) {
   }
 }
-// Browser config - which browser to launch/use (must be Chromium-based, see docs/BROWSERS.md)
+// Browser config- which browser to launch/use (must be Chromium-based, see README.md#Browsers)
 const BROWSER_CONFIG_PATHS = [
   path.join(os.homedir(), '.glider', 'config', 'browser.json'),
   path.join(os.homedir(), '.glider', 'browser.json'),
@@ -82,7 +82,6 @@ for (const cfgPath of BROWSER_CONFIG_PATHS) {
 // 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);
@@ -98,9 +97,9 @@ for (const regPath of BROWSERS_REGISTRY_PATHS) {
 }
 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;
+  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]) {
@@ -679,7 +678,7 @@ async function cmdConnect() {
     await new Promise(r => setTimeout(r, 1000));
   }
-  // 2. Ensure browser is running (see getBrowserConfig + docs/BROWSERS.md)
+  // 2. Ensure browser is running (see getBrowserConfig + README.md#Browsers)
   const browser = getBrowserConfig();
   try {
     execSync(`pgrep -x "${browser.processName}"`, { stdio: 'ignore' });
@@ -701,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 ${browser.name} (Chromium-based only; see glider docs/BROWSERS.md)`);
+    log.info(`Make sure Glider extension is installed in ${browser.name} (Chromium-based only; see glider README.md#Browsers)`);
     process.exit(1);
   }
   log.ok('Extension connected');
@@ -809,9 +808,9 @@ function cmdBrowser() {
     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.');
+  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) {

package/docs/setup.json CHANGED Viewed

@@ -10,7 +10,7 @@
   },
   "requirements": {
     "node": ">=18",
-    "browser": "Chromium-based (Chrome, Arc, Edge, Brave, etc.); see docs/BROWSERS.md",
+    "browser": "Chromium-based (Chrome, Arc, Edge, Brave, etc.); see README Browsers section",
     "os": "macOS (tested), Linux (untested), Windows (untested)"
   },
   "install": {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "glidercli",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "Browser automation CLI. Control Chrome from terminal via CDP, run YAML task files, autonomous loops until completion.",
   "main": "index.js",
   "bin": {

package/docs/BROWSERS.md DELETED Viewed

@@ -1,185 +0,0 @@
-# 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)