@jackwener/opencli 1.5.8 → 1.5.9

package/dist/record.test.js

@@ -0,0 +1,293 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { analyzeRecordedRequests, buildWriteRecordedYaml, createRecordedEntry, generateFullCaptureInterceptorJs, generateRecordedCandidates, } from './record.js';
+import { render } from './pipeline/template.js';
+describe('record request-body capture', () => {
+    it('captures a JSON fetch request body alongside the JSON response body', () => {
+        const entry = createRecordedEntry({
+            url: 'https://api.example.com/tasks',
+            method: 'POST',
+            requestContentType: 'application/json',
+            requestBodyText: '{"title":"Ship #601","priority":"high"}',
+            responseBody: { id: 'task_123', ok: true },
+        });
+        expect(entry).toMatchObject({
+            method: 'POST',
+            requestContentType: 'application/json',
+            requestBody: { title: 'Ship #601', priority: 'high' },
+            responseBody: { id: 'task_123', ok: true },
+        });
+    });
+    it('captures a JSON request body from fetch(Request)', async () => {
+        class MockXMLHttpRequest {
+            open() { }
+            send() { }
+            setRequestHeader() { }
+            addEventListener() { }
+            getResponseHeader() { return null; }
+            responseText = '';
+        }
+        const mockFetch = vi.fn(async () => new Response(JSON.stringify({ id: 'task_123', ok: true }), { headers: { 'content-type': 'application/json' } }));
+        vi.stubGlobal('fetch', mockFetch);
+        vi.stubGlobal('XMLHttpRequest', MockXMLHttpRequest);
+        vi.stubGlobal('window', globalThis);
+        // eslint-disable-next-line no-eval
+        eval(generateFullCaptureInterceptorJs());
+        const request = new Request('https://api.example.com/tasks', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ title: 'Ship #601' }),
+        });
+        await globalThis.fetch(request);
+        const recorded = globalThis.__opencli_record;
+        expect(recorded).toHaveLength(1);
+        expect(recorded?.[0]?.requestBody).toEqual({ title: 'Ship #601' });
+    });
+    it('captures a JSON request body from XHR send()', async () => {
+        class MockXMLHttpRequest {
+            __listeners = {};
+            __rec_url;
+            __rec_method;
+            __rec_request_content_type;
+            responseText = JSON.stringify({ id: 'task_456', ok: true });
+            open(method, url) {
+                this.__rec_method = method;
+                this.__rec_url = url;
+            }
+            send() {
+                for (const listener of this.__listeners.load ?? [])
+                    listener.call(this);
+            }
+            setRequestHeader(name, value) {
+                if (name.toLowerCase() === 'content-type')
+                    this.__rec_request_content_type = value;
+            }
+            addEventListener(event, listener) {
+                this.__listeners[event] ??= [];
+                this.__listeners[event].push(listener);
+            }
+            getResponseHeader(name) {
+                return name.toLowerCase() === 'content-type' ? 'application/json' : null;
+            }
+        }
+        const mockFetch = vi.fn(async () => new Response(JSON.stringify({ ok: true }), { headers: { 'content-type': 'application/json' } }));
+        vi.stubGlobal('fetch', mockFetch);
+        vi.stubGlobal('XMLHttpRequest', MockXMLHttpRequest);
+        vi.stubGlobal('window', globalThis);
+        // eslint-disable-next-line no-eval
+        eval(generateFullCaptureInterceptorJs());
+        const xhr = new XMLHttpRequest();
+        xhr.open('PATCH', 'https://api.example.com/tasks/submit');
+        xhr.setRequestHeader('content-type', 'application/json;charset=utf-8');
+        xhr.send('{"done":true}');
+        const recorded = globalThis.__opencli_record;
+        expect(recorded).toHaveLength(1);
+        expect(recorded?.[0]?.requestBody).toEqual({ done: true });
+    });
+    it('does not interrupt fetch when reading a Request body fails', async () => {
+        class MockXMLHttpRequest {
+            open() { }
+            send() { }
+            setRequestHeader() { }
+            addEventListener() { }
+            getResponseHeader() { return null; }
+            responseText = '';
+        }
+        class BrokenRequest extends Request {
+            clone() {
+                throw new Error('clone failed');
+            }
+        }
+        const mockFetch = vi.fn(async () => new Response(JSON.stringify({ id: 'task_123', ok: true }), { headers: { 'content-type': 'application/json' } }));
+        vi.stubGlobal('fetch', mockFetch);
+        vi.stubGlobal('XMLHttpRequest', MockXMLHttpRequest);
+        vi.stubGlobal('window', globalThis);
+        // eslint-disable-next-line no-eval
+        eval(generateFullCaptureInterceptorJs());
+        const request = new BrokenRequest('https://api.example.com/tasks', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ title: 'Ship #601' }),
+        });
+        await expect(globalThis.fetch(request)).resolves.toBeInstanceOf(Response);
+        expect(mockFetch).toHaveBeenCalledTimes(1);
+    });
+});
+describe('record write candidates', () => {
+    it('keeps a POST request with JSON request body and object response as a write candidate', () => {
+        const result = analyzeRecordedRequests([
+            createRecordedEntry({
+                url: 'https://api.example.com/tasks/create',
+                method: 'POST',
+                requestContentType: 'application/json',
+                requestBodyText: '{"title":"Ship #601"}',
+                responseBody: { id: 'task_123', ok: true },
+            }),
+        ]);
+        expect(result.candidates).toHaveLength(1);
+        expect(result.candidates[0]).toMatchObject({
+            kind: 'write',
+            req: { method: 'POST' },
+        });
+    });
+    it('accepts vendor JSON content types for write candidates', () => {
+        const result = analyzeRecordedRequests([
+            createRecordedEntry({
+                url: 'https://api.example.com/tasks',
+                method: 'POST',
+                requestContentType: 'application/vnd.api+json',
+                requestBodyText: '{"title":"Ship #601"}',
+                responseBody: { id: 'task_123', ok: true },
+            }),
+        ]);
+        expect(result.candidates).toHaveLength(1);
+        expect(result.candidates[0]).toMatchObject({
+            kind: 'write',
+            req: { method: 'POST' },
+        });
+    });
+    it('rejects a POST request that has no usable JSON request body', () => {
+        const result = analyzeRecordedRequests([
+            createRecordedEntry({
+                url: 'https://api.example.com/tasks/create',
+                method: 'POST',
+                requestContentType: 'application/json',
+                requestBodyText: '',
+                responseBody: { id: 'task_123', ok: true },
+            }),
+        ]);
+        expect(result.candidates).toEqual([]);
+    });
+    it('rejects array request and response bodies for first-version write candidates', () => {
+        const result = analyzeRecordedRequests([
+            createRecordedEntry({
+                url: 'https://api.example.com/tasks/batch',
+                method: 'POST',
+                requestContentType: 'application/json',
+                requestBodyText: '[{"title":"Ship #601"}]',
+                responseBody: [{ id: 'task_123' }],
+            }),
+        ]);
+        expect(result.candidates).toEqual([]);
+    });
+    it('generates a write YAML candidate from a replayable JSON write request', () => {
+        const candidates = generateRecordedCandidates('demo', 'https://demo.example.com/app', [
+            createRecordedEntry({
+                url: 'https://api.example.com/tasks/create',
+                method: 'POST',
+                requestContentType: 'application/json',
+                requestBodyText: '{"title":"Ship #601"}',
+                responseBody: { id: 'task_123', ok: true },
+            }),
+        ]);
+        expect(candidates).toHaveLength(1);
+        expect(candidates[0]).toMatchObject({
+            kind: 'write',
+            name: 'create',
+            strategy: 'cookie',
+        });
+        expect(JSON.stringify(candidates[0].yaml)).toContain('Ship #601');
+    });
+    it('builds a write template that replays the recorded JSON body with application/json', () => {
+        const candidate = buildWriteRecordedYaml('demo', 'https://demo.example.com/app', createRecordedEntry({
+            url: 'https://api.example.com/tasks/create',
+            method: 'POST',
+            requestContentType: 'application/json',
+            requestBodyText: '{"title":"Ship #601"}',
+            responseBody: { id: 'task_123', ok: true },
+        }), 'create');
+        expect(candidate.name).toBe('create');
+        expect(JSON.stringify(candidate.yaml)).toContain('method: \\"POST\\"');
+        expect(JSON.stringify(candidate.yaml)).toContain('content-type');
+        expect(JSON.stringify(candidate.yaml)).toContain('Ship #601');
+    });
+});
+describe('record read candidates', () => {
+    it('keeps existing read candidates for array responses', () => {
+        const result = analyzeRecordedRequests([
+            {
+                url: 'https://api.example.com/feed',
+                method: 'GET',
+                status: null,
+                requestContentType: null,
+                responseContentType: 'application/json',
+                requestBody: null,
+                responseBody: { items: [{ title: 'A' }, { title: 'B' }] },
+                contentType: 'application/json',
+                body: { items: [{ title: 'A' }, { title: 'B' }] },
+                capturedAt: 1,
+            },
+        ]);
+        expect(result.candidates).toHaveLength(1);
+        expect(result.candidates[0]).toMatchObject({ kind: 'read' });
+    });
+    it('keeps read YAML generation on the baseline fetch path', () => {
+        const candidates = generateRecordedCandidates('demo', 'https://demo.example.com/app', [
+            createRecordedEntry({
+                url: 'https://api.example.com/search?q=test',
+                method: 'GET',
+                responseBody: { items: [{ title: 'A' }, { title: 'B' }] },
+            }),
+        ]);
+        const yaml = candidates[0].yaml;
+        expect(yaml.pipeline[1]?.evaluate).toContain(`fetch("https://api.example.com/search?q=`);
+        expect(yaml.pipeline[1]?.evaluate).toContain(`{ credentials: 'include' }`);
+        expect(yaml.pipeline[1]?.evaluate).not.toContain('method: "POST"');
+        expect(yaml.pipeline[1]?.evaluate).not.toContain('body: JSON.stringify');
+    });
+    it('renders search and page args into the read YAML fetch URL', () => {
+        const candidates = generateRecordedCandidates('demo', 'https://demo.example.com/app', [
+            createRecordedEntry({
+                url: 'https://api.example.com/search?q=test&page=2',
+                method: 'GET',
+                responseBody: { items: [{ title: 'A' }, { title: 'B' }] },
+            }),
+        ]);
+        const yaml = candidates[0].yaml;
+        const renderedEvaluate = render(yaml.pipeline[1]?.evaluate, {
+            args: { keyword: 'desk', page: 3 },
+        });
+        expect(renderedEvaluate).toContain('https://api.example.com/search?q=desk&page=3');
+    });
+    it('keeps GET and POST candidates separate when they share the same URL pattern', () => {
+        const candidates = generateRecordedCandidates('demo', 'https://demo.example.com/app', [
+            createRecordedEntry({
+                url: 'https://api.example.com/tasks',
+                method: 'GET',
+                responseBody: { items: [{ title: 'A' }, { title: 'B' }] },
+            }),
+            createRecordedEntry({
+                url: 'https://api.example.com/tasks',
+                method: 'POST',
+                requestContentType: 'application/json',
+                requestBodyText: '{"title":"Ship #601"}',
+                responseBody: { id: 'task_123', ok: true },
+            }),
+        ]);
+        expect(candidates).toHaveLength(2);
+        expect(candidates.some((candidate) => candidate.kind === 'read')).toBe(true);
+        expect(candidates.some((candidate) => candidate.kind === 'write')).toBe(true);
+    });
+});
+describe('record noise filtering', () => {
+    it('filters analytics POST noise from write candidates', () => {
+        const result = analyzeRecordedRequests([
+            createRecordedEntry({
+                url: 'https://api.example.com/analytics/event',
+                method: 'POST',
+                requestContentType: 'application/json',
+                requestBodyText: '{"event":"click"}',
+                responseBody: { ok: true, accepted: 1 },
+            }),
+        ]);
+        expect(result.candidates).toEqual([]);
+    });
+});
+afterEach(() => {
+    vi.unstubAllGlobals();
+    Reflect.deleteProperty(globalThis, '__opencli_record');
+    Reflect.deleteProperty(globalThis, '__opencli_record_patched');
+    Reflect.deleteProperty(globalThis, '__opencli_orig_fetch');
+    Reflect.deleteProperty(globalThis, '__opencli_orig_xhr_open');
+    Reflect.deleteProperty(globalThis, '__opencli_orig_xhr_send');
+    Reflect.deleteProperty(globalThis, '__opencli_orig_xhr_set_request_header');
+});

package/dist/registry.d.ts

@@ -55,6 +55,8 @@ export interface CliCommand {
      * - `string`: navigate to this specific URL instead of the domain root
      */
     navigateBefore?: boolean | string;
+    /** Override the default CLI output format when the user does not pass -f/--format. */
+    defaultFormat?: 'table' | 'plain' | 'json' | 'yaml' | 'yml' | 'md' | 'markdown' | 'csv';
 }
 /** Internal extension for lazy-loaded TS modules (not exposed in public API) */
 export interface InternalCliCommand extends CliCommand {

package/dist/registry.js

@@ -32,6 +32,7 @@ export function cli(opts) {
         deprecated: opts.deprecated,
         replacedBy: opts.replacedBy,
         navigateBefore: opts.navigateBefore,
+        defaultFormat: opts.defaultFormat,
     };
     registerCommand(cmd);
     return cmd;

package/dist/registry.test.js

@@ -62,6 +62,16 @@ describe('cli() registration', () => {
         expect(registry.get('test-registry/compat')).toBe(cmd);
         expect(registry.get('test-registry/legacy-name')).toBe(cmd);
     });
+    it('preserves defaultFormat on the registered command', () => {
+        const cmd = cli({
+            site: 'test-registry',
+            name: 'plain-default',
+            description: 'prefers plain output',
+            defaultFormat: 'plain',
+        });
+        expect(cmd.defaultFormat).toBe('plain');
+        expect(getRegistry().get('test-registry/plain-default')?.defaultFormat).toBe('plain');
+    });
 });
 describe('fullName', () => {
     it('returns site/name', () => {

package/dist/runtime.js

@@ -46,9 +46,9 @@ export function withTimeoutMs(promise, timeoutMs, makeError = 'Operation timed o
     });
 }
 export async function browserSession(BrowserFactory, fn, opts = {}) {
-    const mcp = new BrowserFactory();
+    const browser = new BrowserFactory();
     try {
-        const page = await mcp.connect({
+        const page = await browser.connect({
             timeout: DEFAULT_BROWSER_CONNECT_TIMEOUT,
             workspace: opts.workspace,
             cdpEndpoint: opts.cdpEndpoint,
@@ -56,6 +56,6 @@ export async function browserSession(BrowserFactory, fn, opts = {}) {
         return await fn(page);
     }
     finally {
-        await mcp.close().catch(() => { });
+        await browser.close().catch(() => { });
     }
 }

package/dist/snapshotFormatter.d.ts

@@ -1,5 +1,5 @@
 /**
- * Aria snapshot formatter: parses Playwright MCP snapshot text into clean format.
+ * Aria snapshot formatter: parses snapshot text into clean format.
  *
  * 4-pass pipeline:
  * 1. Parse & filter: strip annotations, metadata, noise, ads, boilerplate subtrees

package/dist/snapshotFormatter.js

@@ -1,5 +1,5 @@
 /**
- * Aria snapshot formatter: parses Playwright MCP snapshot text into clean format.
+ * Aria snapshot formatter: parses snapshot text into clean format.
  *
  * 4-pass pipeline:
  * 1. Parse & filter: strip annotations, metadata, noise, ads, boilerplate subtrees
@@ -50,10 +50,10 @@ const BOILERPLATE_LABELS = [
 /**
  * Parse role and text from a trimmed snapshot line.
  * Handles quoted labels and trailing text after colon correctly,
- * including lines wrapped in single quotes by Playwright.
+ * including lines wrapped in single quotes.
  */
 function parseLine(trimmed) {
-    // Unwrap outer single quotes if present (Playwright wraps lines with special chars)
+    // Unwrap outer single quotes if present (snapshot wraps lines with special chars)
     let line = trimmed;
     if (line.startsWith("'") && line.endsWith("':")) {
         line = line.slice(1, -2) + ':';
@@ -90,7 +90,7 @@ function parseLine(trimmed) {
 }
 /**
  * Strip ALL bracket annotations from a content line, preserving quoted strings.
- * Handles both double-quoted and outer single-quoted lines from Playwright.
+ * Handles both double-quoted and outer single-quoted lines.
  */
 function stripAnnotations(content) {
     // Unwrap outer single quotes first

package/dist/snapshotFormatter.test.d.ts

@@ -1,5 +1,5 @@
 /**
- * Tests for snapshotFormatter.ts: Playwright MCP snapshot tree filtering.
+ * Tests for snapshotFormatter.ts: snapshot tree filtering.
  *
  * Uses sanitized excerpts from real websites (GitHub, Bilibili, Twitter)
  * to validate noise filtering, annotation stripping, and output quality.

package/dist/snapshotFormatter.test.js

@@ -1,5 +1,5 @@
 /**
- * Tests for snapshotFormatter.ts: Playwright MCP snapshot tree filtering.
+ * Tests for snapshotFormatter.ts: snapshot tree filtering.
  *
  * Uses sanitized excerpts from real websites (GitHub, Bilibili, Twitter)
  * to validate noise filtering, annotation stripping, and output quality.
@@ -7,7 +7,7 @@
 import { describe, it, expect } from 'vitest';
 import { formatSnapshot } from './snapshotFormatter.js';
 // ---------------------------------------------------------------------------
-// Fixtures: sanitized excerpts from real Playwright MCP snapshots
+// Fixtures: sanitized excerpts from real aria snapshots
 // ---------------------------------------------------------------------------
 /** GitHub dashboard navigation bar (generic-heavy, refs, /url: lines) */
 const GITHUB_NAV = `\

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * Page interface: type-safe abstraction over Playwright MCP browser page.
+ * Page interface: type-safe abstraction over browser page.
  *
  * All pipeline steps and CLI adapters should use this interface
  * instead of `any` for browser interactions.
@@ -78,4 +78,6 @@ export interface IPage {
     closeWindow?(): Promise<void>;
     /** Returns the current page URL, or null if unavailable. */
     getCurrentUrl?(): Promise<string | null>;
+    /** Returns the active tab ID, or undefined if not yet resolved. */
+    getActiveTabId?(): number | undefined;
 }

package/dist/types.js

@@ -1,5 +1,5 @@
 /**
- * Page interface: type-safe abstraction over Playwright MCP browser page.
+ * Page interface: type-safe abstraction over browser page.
  *
  * All pipeline steps and CLI adapters should use this interface
  * instead of `any` for browser interactions.

package/docs/.vitepress/config.mts

@@ -72,6 +72,8 @@ export default defineConfig({
                 { text: 'Band', link: '/adapters/browser/band' },
                 { text: 'Chaoxing', link: '/adapters/browser/chaoxing' },
                 { text: 'Grok', link: '/adapters/browser/grok' },
+                { text: 'Amazon', link: '/adapters/browser/amazon' },
+                { text: 'Gemini', link: '/adapters/browser/gemini' },
                 { text: 'NotebookLM', link: '/adapters/browser/notebooklm' },
                 { text: 'WeRead', link: '/adapters/browser/weread' },
                 { text: 'Douban', link: '/adapters/browser/douban' },

package/docs/adapters/browser/amazon.md

@@ -0,0 +1,53 @@
+# Amazon
+
+**Mode**: 🔐 Browser · **Domain**: `amazon.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli amazon bestsellers [<best-sellers-url>]` | Read Amazon Best Sellers pages for ranked candidate discovery |
+| `opencli amazon search "<query>"` | Read Amazon search results for coarse filtering |
+| `opencli amazon product <asin-or-url>` | Read a product page with title, price, rating, breadcrumbs, and bullets |
+| `opencli amazon offer <asin-or-url>` | Read seller / fulfillment / buy-box facts from the product page |
+| `opencli amazon discussion <asin-or-url>` | Read review summary and sample customer reviews |
+
+## Usage Examples
+
+```bash
+# Root Best Sellers page
+opencli amazon bestsellers https://www.amazon.com/Best-Sellers/zgbs --limit 10 -f json
+
+# Category-specific Best Sellers page
+opencli amazon bestsellers "<category-best-sellers-url>" --limit 50 -f json
+
+# Search products
+opencli amazon search "desk shelf organizer" --limit 20 -f json
+
+# Validate one product
+opencli amazon product B0FJS72893 -f json
+
+# Validate seller / offer facts
+opencli amazon offer B0FJS72893 -f json
+
+# Read review summary + samples
+opencli amazon discussion B0FJS72893 --limit 5 -f json
+```
+
+## Prerequisites
+
+- Chrome running with an active `amazon.com` session in the shared profile
+- [Browser Bridge extension](/guide/browser-bridge) installed
+
+## Notes
+
+- This adapter only returns fields visible on public Amazon pages.
+- `bestsellers` and `search` are for candidate discovery; `product`, `offer`, and `discussion` are the validation surfaces.
+- `offer` is the right surface for `sold_by`, `ships_from`, and Amazon-retail exclusion.
+- `discussion` may return review data even when Q&A is absent. Missing Q&A is a normal outcome, not an error.
+
+## Troubleshooting
+
+- If Amazon shows a robot-check page, clear it in Chrome and retry.
+- If CDP is attached to the wrong tab, retry with `OPENCLI_CDP_TARGET=amazon.com`.
+- Avoid running multiple Amazon browser commands in parallel against the same shared Chrome target.

package/docs/adapters/browser/gemini.md

@@ -0,0 +1,72 @@
+# Gemini
+
+**Mode**: 🔐 Browser · **Domain**: `gemini.google.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli gemini new` | Start a new Gemini web chat |
+| `opencli gemini ask <prompt>` | Send a prompt and return only the assistant reply |
+| `opencli gemini image <prompt>` | Generate images in Gemini and optionally save them locally |
+
+## Usage Examples
+
+```bash
+# Start a fresh chat
+opencli gemini new
+
+# Ask Gemini and return minimal plain-text output
+opencli gemini ask "Reply with exactly: HELLO"
+
+# Ask in a new chat and wait longer
+opencli gemini ask "Summarize this design in 3 bullets" --new true --timeout 90
+
+# Generate an icon image with short flags
+opencli gemini image "Generate a tiny cyan moon icon" --rt 1:1 --st icon
+
+# Only generate in Gemini and print the page link without downloading files
+opencli gemini image "A watercolor sunset over a lake" --sd true
+
+# Save generated images to a custom directory
+opencli gemini image "A flat illustration of a robot" --op ~/tmp/gemini-images
+```
+
+## Options
+
+### `ask`
+
+| Option | Description |
+|--------|-------------|
+| `prompt` | Prompt to send (required positional argument) |
+| `--timeout` | Max seconds to wait for a reply (default: `60`) |
+| `--new` | Start a new chat before sending (default: `false`) |
+
+### `image`
+
+| Option | Description |
+|--------|-------------|
+| `prompt` | Image prompt to send (required positional argument) |
+| `--rt` | Aspect ratio shorthand: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3` |
+| `--st` | Optional style shorthand, e.g. `icon`, `anime`, `watercolor` |
+| `--op` | Output directory for downloaded images (default: `~/tmp/gemini-images`) |
+| `--sd` | Skip download and only print the Gemini page link |
+
+## Behavior
+
+- `ask` uses plain minimal output and returns only the assistant response text prefixed with `💬`.
+- `image` also uses plain output and prints `status / file / link` instead of a table.
+- `image` always starts from a fresh Gemini chat before sending the prompt.
+- When `--sd` is enabled, `image` keeps the generation in Gemini and only prints the conversation link.
+
+## Prerequisites
+
+- Chrome is running
+- You are already logged into `gemini.google.com`
+- [Browser Bridge extension](/guide/browser-bridge) is installed
+
+## Caveats
+
+- This adapter drives the Gemini consumer web UI, not a public API.
+- It depends on the current browser session and may fail if Gemini shows login, consent, challenge, quota, or other gating UI.
+- DOM or product changes on Gemini can break composer detection, new-chat handling, or image export behavior.

package/docs/adapters/browser/notebooklm.md

@@ -8,7 +8,8 @@
 |---------|-------------|
 | `opencli notebooklm status` | Check whether NotebookLM is reachable in the current Chrome session |
 | `opencli notebooklm list` | List notebooks visible from the NotebookLM home page |
-| `opencli notebooklm current` | Show metadata for the currently opened notebook tab |
+| `opencli notebooklm open <notebook>` | Open one notebook in the NotebookLM automation workspace by id or URL |
+| `opencli notebooklm current` | Show metadata for the currently opened notebook in the automation workspace |
 | `opencli notebooklm get` | Get richer metadata for the current notebook |
 | `opencli notebooklm source-list` | List sources in the current notebook |
 | `opencli notebooklm source-get <source>` | Resolve one source in the current notebook by id or title |
@@ -17,15 +18,14 @@
 | `opencli notebooklm history` | List conversation history threads for the current notebook |
 | `opencli notebooklm note-list` | List Studio notes visible in the current notebook |
 | `opencli notebooklm notes-get <note>` | Read the currently visible Studio note by title |
-| `opencli notebooklm bind-current` | Bind the current active NotebookLM tab into the `site:notebooklm` workspace |
 | `opencli notebooklm summary` | Read the current notebook summary |
 
 ## Compatibility Aliases
 
 | Alias | Canonical command |
 |-------|-------------------|
+| `opencli notebooklm select <notebook>` | `opencli notebooklm open <notebook>` |
 | `opencli notebooklm metadata` | `opencli notebooklm get` |
-| `opencli notebooklm use` | `opencli notebooklm bind-current` |
 | `opencli notebooklm notes-list` | `opencli notebooklm note-list` |
 
 ## Positioning
@@ -43,6 +43,7 @@ The current milestone focuses on a stable NotebookLM read surface in desktop Chr
 ```bash
 opencli notebooklm status
 opencli notebooklm list -f json
+opencli notebooklm open nb-demo -f json
 opencli notebooklm current -f json
 opencli notebooklm metadata -f json
 opencli notebooklm source-list -f json
@@ -53,7 +54,6 @@ opencli notebooklm history -f json
 opencli notebooklm notes-list -f json
 opencli notebooklm notes-get "Draft note" -f json
 opencli notebooklm summary -f json
-opencli notebooklm use -f json
 ```
 
 ## Prerequisites
@@ -64,6 +64,6 @@ opencli notebooklm use -f json
 
 ## Notes
 
-- Notebook-oriented commands assume you already have the target notebook open in Chrome, or that `opencli notebooklm use` can bind an existing notebook tab into `site:notebooklm`.
+- Notebook-oriented commands run in OpenCLI's owned NotebookLM automation workspace/window. Use `opencli notebooklm open <notebook>` first to choose the current notebook for follow-up commands.
 - `list`, `get`, `source-list`, `history`, `source-fulltext`, and `source-guide` prefer NotebookLM RPC paths and fall back only when the richer path is unavailable.
 - `notes-get` currently reads note content only from the visible Studio note editor; if the note is listed but not open, open it in NotebookLM first and then retry.

package/docs/adapters/index.md

@@ -29,7 +29,8 @@ Run `opencli list` for the live registry.
 | **[linux-do](./browser/linux-do)** | `feed` `categories` `tags` `search` `topic` `user-topics` `user-posts` | 🔐 Browser |
 | **[chaoxing](./browser/chaoxing)** | `assignments` `exams` | 🔐 Browser |
 | **[grok](./browser/grok)** | `ask` | 🔐 Browser |
-| **[notebooklm](./browser/notebooklm)** | `status` `list` `current` `get` `metadata` `bind-current` `use` `source-list` `source-get` `source-fulltext` `source-guide` `history` `note-list` `notes-list` `notes-get` `summary` | 🔐 Browser |
+| **[gemini](./browser/gemini)** | `new` `ask` `image` | 🔐 Browser |
+| **[notebooklm](./browser/notebooklm)** | `status` `list` `open` `select` `current` `get` `metadata` `source-list` `source-get` `source-fulltext` `source-guide` `history` `note-list` `notes-list` `notes-get` `summary` | 🔐 Browser |
 | **[doubao](./browser/doubao)** | `status` `new` `send` `read` `ask` `history` `detail` `meeting-summary` `meeting-transcript` | 🔐 Browser |
 | **[weread](./browser/weread)** | `shelf` `search` `book` `ranking` `notebooks` `highlights` `notes` | 🔐 Browser |
 | **[douban](./browser/douban)** | `search` `top250` `subject` `photos` `download` `marks` `reviews` `movie-hot` `book-hot` | 🔐 Browser |
@@ -43,6 +44,7 @@ Run `opencli list` for the live registry.
 | **[tiktok](./browser/tiktok)** | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` | 🔐 Browser |
 | **[google](./browser/google)** | `news` `search` `suggest` `trends` | 🌐 / 🔐 |
 | **[jd](./browser/jd)** | `item` | 🔐 Browser |
+| **[amazon](./browser/amazon)** | `bestsellers` `search` `product` `offer` `discussion` | 🔐 Browser |
 | **[web](./browser/web)** | `read` | 🔐 Browser |
 | **[weixin](./browser/weixin)** | `download` | 🔐 Browser |
 | **[36kr](./browser/36kr)** | `news` `hot` `search` `article` | 🌐 / 🔐 |