glidercli 0.3.9 → 0.3.13

package/README.md

@@ -8,195 +8,116 @@
 <h1 align="center">glider CLI</h1>
 <p align="center"><i><b>Browser automation CLI with autonomous loop execution</b></i></p>
 
-<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>
+<a href="https://github.com/vdutts7/glidercli"><img src="./assets/badges/github.badge.svg" alt="GitHub" height="34" /></a>
+<a href="https://www.npmjs.com/package/glidercli"><img src="./assets/badges/npm.badge.svg" alt="glidercli on npm" height="34" /></a>
 
 </div>
 
 <br/>
 
-## About
-
-| | |
-|---|---|
-| **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 |
-
 ---
 
-## Install
-
-| 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. |
-
-
-## Requirements
+| | headless CDP | extension relay (glider) |
+|---|--------------|---------------------------|
+| logged-in tab / SSO | ❌ cold profile | ✅ attach to open tab |
+| corp / MFA sessions | ❌ re-auth wall | ✅ reuse browser cookies |
+| loop until done | manual glue | ✅ `glider loop` + markers |
 
-| 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 |
+`glidercli` → relay at `ws://127.0.0.1:19988` → [`Glider extension`](https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj) → CDP on your tab.
 
 ---
 
-## Browsers
-
-| | |
-|---|---|
-| **How it works** | Chrome extension → WebSocket relay → CDP. Browser must support that extension (Chromium-based). |
+## Issue
 
-### Browser support
+| failure mode | symptom |
+|--------------|---------|
+| ❌ cold profile launch | SSO/MFA breaks on internal sites; no logged-in tab to drive |
+| ❌ raw CDP without bridge | extension must relay debugger traffic from real Chromium profile |
+| ❌ cookie-only terminal fetch | cross-origin API hosts often 401 without in-tab bearer |
+| ❌ one-shot scripts only | no first-class loop with iteration cap, timeout, completion marker |
 
-**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/chrome-canary.webp" width="16" alt=""> | Chrome Canary | n/a |
-| <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/safari-technology-preview.webp" width="16" alt=""> | Safari Technology Preview | WebKit preview channel (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/dia-browser.webp" width="16" alt=""> | Dia | AI-first browser, not in Glider’s supported Chromium + CWS model today |
-| <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/whale-browser.webp" width="16" alt=""> | Whale Browser | Chromium-based, support not implemented in Glider today |
-| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/yandex-browser.webp" width="16" alt=""> | Yandex Browser | Chromium-based, support not implemented in Glider 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.
+## Setup
 
-```json
-{
-  "use": "arc"
-}
+```bash
+npm i -g glidercli
+glider install
+glider connect
 ```
 
-Registry is loaded from: `$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
+| Step | Action |
+|------|--------|
+| CLI | `npm i -g glidercli` |
+| Extension | [`Glider` on Chrome Web Store](https://chromewebstore.google.com/detail/glider/njbidokkffhgpofcejgcfcgcinmeoalj) in the profile you automate |
+| Daemon | `glider install` |
+| Session | `glider connect` (once per browser launch) |
 
-**Option B- Explicit name/path:**
+Node 18+. Chromium-based browser with the extension enabled (see Browsers).
 
-| 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).
+## Browsers
 
-**Example:**
+Extension + relay model uses Chromium + Glider extension from Chrome Web Store in the same profile as `glider connect`.
 
-```json
-{
-  "name": "Arc",
-  "path": "/Applications/Arc.app",
-  "processName": "Arc"
-}
-```
+| | 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 | [`config/browser.json.example`](config/browser.json.example) |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/microsoft/microsoft-edge.webp" width="16" alt=""> | Microsoft Edge | registry key `edge` |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/brave.webp" width="16" alt=""> | Brave | registry key `brave` |
+| <img src="https://raw.githubusercontent.com/vdutts7/squircle/main/webp/vivaldi.webp" width="16" alt=""> | Vivaldi | registry key `vivaldi` |
 
-**By browser:**
+Not supported today: Firefox/Safari/WebKit/Gecko, DuckDuckGo, browsers without Chrome Web Store extension path.
 
-| 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` |
+### Browser config
 
-Check app name in Finder/Spotlight, process name: `ps aux | grep -i <name>`
+Priority: `~/.glider/config/browser.json` → default Google Chrome.
 
-### Browser registry (keymap)
+Registry key (recommended):
 
-A single registry file can define all Chromium browsers, Glider picks one by **key**
+```json
+{ "use": "arc" }
+```
 
-**Registry location:**
+Registry file: `~/.glider/config/browsers-registry.json`
 
-- `$HOME/.glider/config/browsers-registry.json`
+```bash
+glider use arc
+glider browser
+```
 
-**Registry format:**
+Explicit name/path:
 
 ```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" }
-  }
+  "name": "Arc",
+  "path": "/Applications/Arc.app",
+  "processName": "Arc"
 }
 ```
 
-**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.
+| `glider use arc` | write `{ "use": "arc" }` to `browser.json` |
+| `glider use` | list registry keys |
+| `glider browser` | show resolved name, path, process |
 
-### Platform
+macOS: `open -a` / AppleScript. Linux/Windows: partial, on roadmap.
 
-| 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
+## Task files
 
-| 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/.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 |
+```yaml
+name: hn-front
+steps:
+  goto: "https://news.ycombinator.com"
+  wait: 2
+  eval: "document.title"
+  screenshot: "/tmp/hn.png"
+```
 
 ---
 
@@ -205,28 +126,41 @@ Add or edit entries in the registry to match your machine (e.g. custom install p
 ```bash
 glider connect
 glider status
-glider goto "https://reddit.com"
+glider goto "https://news.ycombinator.com"
 glider eval "document.title"
-glider run task.yaml
-glider loop task.yaml -n 50
+glider run `hn-scrape.yaml`
+glider loop `hn-scrape.yaml` -n 50 -m hn_scrape_done
 ```
 
-| Daemon | Logs |
+```bash
+# per-host capture hints (optional)
+glider resolve https://news.ycombinator.com --json
+```
+
+| Output | Path |
 |--------|------|
-| `glider install` / `glider uninstall` | `~/.glider/daemon.log` |
+| daemon log | `~/.glider/daemon.log` |
+| domain index | `~/.glider/config/domains.json` |
+| per-host intel | `~/.glider/warch/HOST/glider.json` |
+| explore cache | `~/.glider/bexplore/HOST/` |
+
+| Env | Default | Role |
+|-----|---------|------|
+| `GLIDER_HOME` | `~/.glider` | config, cache, warch tree |
+| `AGREGISTRY` | unset | optional registry root → warch at `$AGREGISTRY/warch/HOST/` |
+
+Copy `config/domains.template.json` into `~/.glider/config/domains.json` to seed the host index.
 
 ---
 
-## Task files
+## Gotchas
 
-```yaml
-name: "Reddit"
-steps:
- - goto: "https://reddit.com"
- - wait: 2
- - eval: "document.title"
- - screenshot: "/tmp/out.png"
-```
+| problem | fix | stability | why |
+|---------|-----|-----------|-----|
+| extension not connected | click Glider icon in toolbar → `glider connect` | per Chrome launch | relay waits on extension WS |
+| wrong tab targeted | `glider targets` → `glider use-session session-6` | session-stable | multi-tab needs explicit session |
+| explore HAR empty bodies | replay in-tab with auth hook on XHR/fetch | site-specific | some SPAs never expose bearer in storage |
+| `resolve` misses host | add `~/.glider/warch/HOST/glider.json` or set `AGREGISTRY` | file-stable | optional per-host capture hints |
 
 ---
 
@@ -234,42 +168,32 @@ steps:
 
 | Command | Description |
 |---------|-------------|
-| `glider install` | Install daemon (relay at login) |
-| `glider uninstall` | Remove daemon |
-| `glider connect` | Connect to browser |
-| `glider status` | Server / extension / tabs |
-| `glider browser` | Show browser config (name, path) |
-| `glider goto <url>` | Navigate |
-| `glider eval <js>` | Run JS in page |
-| `glider click <sel>` | Click element |
-| `glider type <sel> <text>` | Type into input |
-| `glider screenshot [path]` | Capture page |
-| `glider run <file>` | Run YAML task |
-| `glider loop <file> [-n N]` | Loop until done or limit |
-
-Full list: `glider --help`
-
----
+| `glider install` / `uninstall` | daemon at login |
+| `glider connect` | attach relay to browser |
+| `glider status` | server, extension, tabs |
+| `glider goto` / `eval` / `click` / `type` | page ops |
+| `glider screenshot` | PNG capture |
+| `glider explore` | crawl + HAR |
+| `glider resolve` | host → local warch intel (`--json`) |
+| `glider run` / `loop` | YAML task / Ralph loop |
 
-## Docs
-
-| Doc | Contents |
-|-----|----------|
-| This README | Install, usage, commands, full browser support/config |
-| [config/browser.json.example](config/browser.json.example) | Example browser config |
+Full surface: `glider --help`
 
 ---
 
 ## Roadmap
 
-- [x] CDP relay + extension, YAML tasks, loop, daemon, multi-tab
-- [ ] Linux / Windows
-- [ ] headless (cloud)
-- [ ] task chaining
-- [ ] crawling templates
+| status | item |
+|--------|------|
+| done | CDP relay, YAML tasks, loop, daemon, multi-tab, `resolve` |
+| planned | Linux and Windows browser launch |
+| | headless cloud mode |
+| | task chaining |
 
 ---
 
 ## 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>
+[![`vd7.io`](https://res.cloudinary.com/ddyc1es5v/image/upload/v1773910810/readme-badges/readme-badge-vd7.png)](https://vd7.io)
+
+[![`@vdutts7`](https://res.cloudinary.com/ddyc1es5v/image/upload/v1773910817/readme-badges/readme-badge-x.png)](https://x.com/vdutts7)

package/bin/glider.js

@@ -57,6 +57,7 @@ if (fs.existsSync(REGISTRY_FILE)) {
 
 // Direct CDP module
 const { DirectCDP, checkChrome } = require(path.join(LIB_DIR, 'cdp-direct.js'));
+const { resolveDomain } = require(path.join(LIB_DIR, 'domain-resolve.js'));
 
 // Domain extensions - load from ~/.glider/config/domains.json
 const DOMAIN_CONFIG_PATHS = [
@@ -1069,7 +1070,7 @@ async function cmdWindow(args) {
 }
 
 async function cmdDomains() {
-  const domainKeys = Object.keys(DOMAINS);
+  const domainKeys = Object.keys(DOMAINS).filter((k) => k !== 'meta');
   if (domainKeys.length === 0) {
     log.warn('No domains configured');
     log.info('Add domains to ~/.glider/config/domains.json');
@@ -1078,12 +1079,28 @@ async function cmdDomains() {
   console.log(`${GREEN}${domainKeys.length}${NC} domain(s) configured:\n`);
   for (const key of domainKeys) {
     const d = DOMAINS[key];
-    const type = d.script ? 'script' : 'url';
-    const target = d.script || d.url || '';
+    const shortcut = d.shortcut || {};
+    const type = shortcut.type || (d.script ? 'script' : d.url ? 'url' : 'none');
+    const target = shortcut.target || d.script || d.url || '';
     console.log(`  ${CYAN}${key}${NC} ${DIM}(${type})${NC}`);
+    if (d.host) console.log(`      ${DIM}host: ${d.host}${NC}`);
+    if (d.warch) console.log(`      ${DIM}warch: ${d.warch}${NC}`);
     if (d.description) console.log(`      ${d.description}`);
-    console.log(`      ${DIM}${target}${NC}`);
+    if (target) console.log(`      ${DIM}${target}${NC}`);
+  }
+}
+
+async function cmdResolve(input, opts = []) {
+  if (!input) {
+    log.fail('Usage: glider resolve <url|host> [--json]');
+    process.exit(1);
+  }
+  const result = resolveDomain(input);
+  if (opts.includes('--json') || jsonOutput) {
+    console.log(JSON.stringify({ ok: true, ...result }));
+    return;
   }
+  console.log(JSON.stringify(result, null, 2));
 }
 
 async function cmdOpen(url) {
@@ -1955,6 +1972,8 @@ ${B5}STATUS${NC}
     ${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
+    ${BW}domains${NC}             List ~/.glider domain shortcuts + warch paths
+    ${BW}resolve${NC} <url>        Domain intel under ~/.glider/warch ${DIM}(--json)${NC}
 
 ${B5}NAVIGATION${NC}
     ${BW}goto${NC} <url>          Navigate to URL
@@ -2144,7 +2163,7 @@ async function main() {
   }
   
   // Ensure server is running for most commands
-  if (!['start', 'stop', 'help', '--help', '-h', 'update', 'version', '-v', '--version'].includes(cmd)) {
+  if (!['start', 'stop', 'help', '--help', '-h', 'update', 'version', '-v', '--version', 'domains', 'resolve'].includes(cmd)) {
     if (!await checkServer()) {
       log.info('Server not running, starting...');
       await cmdStart();
@@ -2214,6 +2233,9 @@ async function main() {
     case 'domains':
       await cmdDomains();
       break;
+    case 'resolve':
+      await cmdResolve(args[1], args.slice(2));
+      break;
     case 'goto':
     case 'navigate':
       await cmdGoto(args[1]);
@@ -2297,9 +2319,11 @@ async function main() {
       // Check if it's a domain command from config
       if (DOMAINS[cmd]) {
         const domain = DOMAINS[cmd];
-        if (domain.script) {
-          // Execute external script
-          const scriptPath = domain.script.replace(/^~/, os.homedir());
+        const shortcut = domain.shortcut || {};
+        const scriptPathRaw = shortcut.type === 'script' ? shortcut.target : domain.script;
+        const urlRaw = shortcut.type === 'url' ? shortcut.target : domain.url;
+        if (scriptPathRaw) {
+          const scriptPath = scriptPathRaw.replace(/^~/, os.homedir()).replace(/\$HOME/g, os.homedir());
           if (fs.existsSync(scriptPath)) {
             const { execSync } = require('child_process');
             try {
@@ -2311,9 +2335,8 @@ async function main() {
             log.fail(`Domain script not found: ${scriptPath}`);
             process.exit(1);
           }
-        } else if (domain.url) {
-          // Navigate to domain URL
-          await cmdGoto(domain.url);
+        } else if (urlRaw) {
+          await cmdGoto(urlRaw);
         }
         break;
       }

package/config/domains.template.json

@@ -0,0 +1,15 @@
+{
+  "meta": {
+    "schema_version": "2.0",
+    "description": "Domain index: host → warch dir under registry base",
+    "registry_base": "AGREGISTRY env if set, else GLIDER_HOME (~/.glider)",
+    "warch_layout": "<registry_base>/warch/<host>/"
+  },
+  "example_com": {
+    "host": "example.com",
+    "warch": "warch/example.com",
+    "shortcut": { "type": "none", "target": null },
+    "description": "Replace with your domain",
+    "notes": "glider.json + gotchas.json under warch/<host>/"
+  }
+}

package/docs/setup.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "project": "glidercli",
-    "updated": "2026-01-31"
+    "updated": "2026-07-06"
   },
   "architecture": {
     "flow": "glidercli -> bserve (ws:19988) -> chrome-extension -> chrome.debugger -> tab",
@@ -32,7 +32,12 @@
     }
   },
   "config_paths": {
+    "glider_home": "~/.glider (override: GLIDER_HOME)",
     "domains": "~/.glider/config/domains.json",
+    "domains_template": "config/domains.template.json (shipped in package)",
+    "warch_root": "<registry_base>/warch/<host>/ (glider.json, gotchas.json, bexplore/)",
+    "registry_base": "AGREGISTRY if set, else GLIDER_HOME (~/.glider)",
+    "resolve": "glider resolve <url> --json",
     "browser": "~/.glider/config/browser.json",
     "daemon_log": "~/.glider/daemon.log"
   },

package/lib/domain-resolve.js

@@ -0,0 +1,75 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { URL } = require('url');
+const {
+  configPath,
+  gliderHome,
+  registryBase,
+  registryMode,
+  warchDirForHost,
+  warchRoot,
+} = require('./paths.js');
+
+function loadDomainsIndex() {
+  for (const cfgPath of configPath('domains.json')) {
+    if (!fs.existsSync(cfgPath)) continue;
+    try {
+      return JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+    } catch (_) { /* ignore */ }
+  }
+  return {};
+}
+
+function hostFromUrl(input) {
+  if (!input) return null;
+  try {
+    const u = input.includes('://') ? input : `https://${input}`;
+    return new URL(u).hostname || null;
+  } catch (_) {
+    return null;
+  }
+}
+
+function resolveDomain(input) {
+  const host = hostFromUrl(input);
+  const domains = loadDomainsIndex();
+  const warchPath = host ? warchDirForHost(host, domains) : null;
+  const gliderJsonPath = warchPath && path.join(warchPath, 'glider.json');
+  const gotchasPath = warchPath && path.join(warchPath, 'gotchas.json');
+  const gliderJsonExists = !!(gliderJsonPath && fs.existsSync(gliderJsonPath));
+  const gotchasExists = !!(gotchasPath && fs.existsSync(gotchasPath));
+  let gliderJson = null;
+  if (gliderJsonExists) {
+    try {
+      gliderJson = JSON.parse(fs.readFileSync(gliderJsonPath, 'utf8'));
+    } catch (_) { /* ignore */ }
+  }
+  return {
+    host,
+    registry_mode: registryMode(),
+    glider_home: gliderHome(),
+    registry_base: registryBase(),
+    warch_root: warchRoot(),
+    warch_path: warchPath,
+    glider_json_exists: gliderJsonExists,
+    gotchas_exists: gotchasExists,
+    domains_index_hit: host ? Object.keys(domains).find((k) => {
+      if (k === 'meta') return false;
+      const v = domains[k];
+      return v && typeof v === 'object' && (v.host === host || k === host);
+    }) ?? null : null,
+    capture_mode: gliderJson?.capture_mode ?? null,
+    wait_ms: gliderJson?.wait_ms ?? null,
+    auth_mode: gliderJson?.auth_mode ?? null,
+  };
+}
+
+module.exports = {
+  resolveDomain,
+  hostFromUrl,
+  warchRoot,
+  loadDomainsIndex,
+  gliderHome,
+};

package/lib/paths.js

@@ -0,0 +1,76 @@
+'use strict';
+
+const os = require('os');
+const path = require('path');
+
+/** Browser runtime data — always ~/.glider unless GLIDER_HOME set. */
+function gliderHome() {
+  return process.env.GLIDER_HOME || path.join(os.homedir(), '.glider');
+}
+
+/** Installed package root (glidercli npm tree). */
+function packageRoot() {
+  return path.join(__dirname, '..');
+}
+
+/** Registry base for warch: AGREGISTRY or GLIDER_HOME. */
+function registryBase() {
+  const ag = process.env.AGREGISTRY;
+  if (ag) return expandUser(ag);
+  return gliderHome();
+}
+
+function registryMode() {
+  return process.env.AGREGISTRY ? 'agents' : 'standalone';
+}
+
+function configPath(name) {
+  const home = gliderHome();
+  return [
+    path.join(home, 'config', name),
+    path.join(home, name),
+  ];
+}
+
+/** Domain intel: $AGREGISTRY/warch or ~/.glider/warch when AGREGISTRY unset. */
+function warchRoot() {
+  return path.join(registryBase(), 'warch');
+}
+
+function domainsTemplatePath() {
+  return path.join(packageRoot(), 'config', 'domains.template.json');
+}
+
+function expandUser(p) {
+  if (!p || typeof p !== 'string') return p;
+  return p.replace(/^~(?=$|[/\\])/, os.homedir());
+}
+
+/** warch dir: domains.json entry (relative to registryBase) or warch/<host>. */
+function warchDirForHost(host, domainsIndex) {
+  if (!host) return null;
+  const domains = domainsIndex || {};
+  const base = registryBase();
+  for (const [key, val] of Object.entries(domains)) {
+    if (key === 'meta' || !val || typeof val !== 'object') continue;
+    if (val.host !== host && key !== host) continue;
+    if (val.warch) {
+      const raw = expandUser(String(val.warch));
+      return path.isAbsolute(raw) ? raw : path.join(base, raw);
+    }
+    break;
+  }
+  return path.join(warchRoot(), host);
+}
+
+module.exports = {
+  gliderHome,
+  packageRoot,
+  registryBase,
+  registryMode,
+  configPath,
+  warchRoot,
+  domainsTemplatePath,
+  expandUser,
+  warchDirForHost,
+};

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "glidercli",
-  "version": "0.3.9",
+  "version": "0.3.13",
   "description": "Browser automation CLI. Control Chrome from terminal via CDP, run YAML task files, autonomous loops until completion.",
   "main": "index.js",
   "bin": {
     "glider": "bin/glider.js"
   },
   "scripts": {
-    "test": "node bin/glider.js --help"
+    "test": "node bin/glider.js --help && bash scripts/ship-gate.sh"
   },
   "keywords": [
     "browser",