@jackwener/opencli 1.5.6 → 1.5.8

package/dist/registry.js

@@ -13,9 +13,11 @@ const _registry = globalThis.__opencli_registry__ ??= new Map();
 export function cli(opts) {
     const strategy = opts.strategy ?? (opts.browser === false ? Strategy.PUBLIC : Strategy.COOKIE);
     const browser = opts.browser ?? (strategy !== Strategy.PUBLIC);
+    const aliases = normalizeAliases(opts.aliases, opts.name);
     const cmd = {
         site: opts.site,
         name: opts.name,
+        aliases,
         description: opts.description ?? '',
         domain: opts.domain,
         strategy,
@@ -31,8 +33,7 @@ export function cli(opts) {
         replacedBy: opts.replacedBy,
         navigateBefore: opts.navigateBefore,
     };
-    const key = fullName(cmd);
-    _registry.set(key, cmd);
+    registerCommand(cmd);
     return cmd;
 }
 export function getRegistry() {
@@ -45,5 +46,32 @@ export function strategyLabel(cmd) {
     return cmd.strategy ?? Strategy.PUBLIC;
 }
 export function registerCommand(cmd) {
-    _registry.set(fullName(cmd), cmd);
+    const canonicalKey = fullName(cmd);
+    const existing = _registry.get(canonicalKey);
+    if (existing) {
+        for (const [key, value] of _registry.entries()) {
+            if (value === existing && key !== canonicalKey)
+                _registry.delete(key);
+        }
+    }
+    const aliases = normalizeAliases(cmd.aliases, cmd.name);
+    cmd.aliases = aliases.length > 0 ? aliases : undefined;
+    _registry.set(canonicalKey, cmd);
+    for (const alias of aliases) {
+        _registry.set(`${cmd.site}/${alias}`, cmd);
+    }
+}
+function normalizeAliases(aliases, commandName) {
+    if (!Array.isArray(aliases) || aliases.length === 0)
+        return [];
+    const seen = new Set();
+    const normalized = [];
+    for (const alias of aliases) {
+        const value = typeof alias === 'string' ? alias.trim() : '';
+        if (!value || value === commandName || seen.has(value))
+            continue;
+        seen.add(value);
+        normalized.push(value);
+    }
+    return normalized;
 }

package/dist/registry.test.js

@@ -49,6 +49,19 @@ describe('cli() registration', () => {
         const reg = getRegistry();
         expect(reg.get('test-registry/overwrite')?.description).toBe('v2');
     });
+    it('registers aliases as alternate registry keys for the same command', () => {
+        const cmd = cli({
+            site: 'test-registry',
+            name: 'canonical',
+            description: 'test aliases',
+            aliases: ['compat', 'legacy-name'],
+        });
+        const registry = getRegistry();
+        expect(cmd.aliases).toEqual(['compat', 'legacy-name']);
+        expect(registry.get('test-registry/canonical')).toBe(cmd);
+        expect(registry.get('test-registry/compat')).toBe(cmd);
+        expect(registry.get('test-registry/legacy-name')).toBe(cmd);
+    });
 });
 describe('fullName', () => {
     it('returns site/name', () => {

package/dist/runtime.d.ts

@@ -1,9 +1,9 @@
 import type { IPage } from './types.js';
 /**
- * Returns the appropriate browser factory based on environment config.
- * Uses CDPBridge when OPENCLI_CDP_ENDPOINT is set, otherwise BrowserBridge.
+ * Returns the appropriate browser factory based on site type.
+ * Uses CDPBridge for registered Electron apps, otherwise BrowserBridge.
  */
-export declare function getBrowserFactory(): new () => IBrowserFactory;
+export declare function getBrowserFactory(site?: string): new () => IBrowserFactory;
 export declare const DEFAULT_BROWSER_CONNECT_TIMEOUT: number;
 export declare const DEFAULT_BROWSER_COMMAND_TIMEOUT: number;
 export declare const DEFAULT_BROWSER_EXPLORE_TIMEOUT: number;
@@ -26,9 +26,11 @@ export interface IBrowserFactory {
     connect(opts?: {
         timeout?: number;
         workspace?: string;
+        cdpEndpoint?: string;
     }): Promise<IPage>;
     close(): Promise<void>;
 }
 export declare function browserSession<T>(BrowserFactory: new () => IBrowserFactory, fn: (page: IPage) => Promise<T>, opts?: {
     workspace?: string;
+    cdpEndpoint?: string;
 }): Promise<T>;

package/dist/runtime.js

@@ -1,11 +1,14 @@
 import { BrowserBridge, CDPBridge } from './browser/index.js';
 import { TimeoutError } from './errors.js';
+import { isElectronApp } from './electron-apps.js';
 /**
- * Returns the appropriate browser factory based on environment config.
- * Uses CDPBridge when OPENCLI_CDP_ENDPOINT is set, otherwise BrowserBridge.
+ * Returns the appropriate browser factory based on site type.
+ * Uses CDPBridge for registered Electron apps, otherwise BrowserBridge.
  */
-export function getBrowserFactory() {
-    return process.env.OPENCLI_CDP_ENDPOINT ? CDPBridge : BrowserBridge;
+export function getBrowserFactory(site) {
+    if (site && isElectronApp(site))
+        return CDPBridge;
+    return BrowserBridge;
 }
 function parseEnvTimeout(envVar, fallback) {
     const raw = process.env[envVar];
@@ -45,7 +48,11 @@ export function withTimeoutMs(promise, timeoutMs, makeError = 'Operation timed o
 export async function browserSession(BrowserFactory, fn, opts = {}) {
     const mcp = new BrowserFactory();
     try {
-        const page = await mcp.connect({ timeout: DEFAULT_BROWSER_CONNECT_TIMEOUT, workspace: opts.workspace });
+        const page = await mcp.connect({
+            timeout: DEFAULT_BROWSER_CONNECT_TIMEOUT,
+            workspace: opts.workspace,
+            cdpEndpoint: opts.cdpEndpoint,
+        });
         return await fn(page);
     }
     finally {

package/dist/serialization.d.ts

@@ -21,6 +21,7 @@ export declare function serializeCommand(cmd: CliCommand): {
     command: string;
     site: string;
     name: string;
+    aliases: string[];
     description: string;
     strategy: string;
     browser: boolean;

package/dist/serialization.js

@@ -23,6 +23,7 @@ export function serializeCommand(cmd) {
         command: fullName(cmd),
         site: cmd.site,
         name: cmd.name,
+        aliases: cmd.aliases ?? [],
         description: cmd.description,
         strategy: strategyLabel(cmd),
         browser: !!cmd.browser,
@@ -67,6 +68,8 @@ export function formatRegistryHelpText(cmd) {
         meta.push(`Deprecated: ${typeof cmd.deprecated === 'string' ? cmd.deprecated : 'yes'}`);
     if (cmd.replacedBy)
         meta.push(`Use instead: ${cmd.replacedBy}`);
+    if (cmd.aliases?.length)
+        meta.push(`Aliases: ${cmd.aliases.join(', ')}`);
     lines.push(meta.join(' | '));
     if (cmd.columns?.length)
         lines.push(`Output columns: ${cmd.columns.join(', ')}`);

package/dist/serialization.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import { Strategy } from './registry.js';
-import { formatRegistryHelpText } from './serialization.js';
+import { formatRegistryHelpText, serializeCommand } from './serialization.js';
 describe('formatRegistryHelpText', () => {
     it('summarizes long choices lists so help text stays readable', () => {
         const cmd = {
@@ -20,4 +20,20 @@ describe('formatRegistryHelpText', () => {
         };
         expect(formatRegistryHelpText(cmd)).toContain('--field: all-fields, topic, title, author, ... (+3 more)');
     });
+    it('includes aliases in structured serialization and help text', () => {
+        const cmd = {
+            site: 'demo',
+            name: 'get',
+            aliases: ['metadata'],
+            description: 'Demo command',
+            strategy: Strategy.COOKIE,
+            browser: true,
+            args: [],
+        };
+        expect(serializeCommand(cmd)).toMatchObject({
+            command: 'demo/get',
+            aliases: ['metadata'],
+        });
+        expect(formatRegistryHelpText(cmd)).toContain('Aliases: metadata');
+    });
 });

package/dist/tui.d.ts

@@ -20,3 +20,10 @@ export declare function checkboxPrompt(items: CheckboxItem[], opts?: {
     title?: string;
     hint?: string;
 }): Promise<string[]>;
+/**
+ * Simple yes/no confirmation prompt.
+ *
+ * In non-TTY environments, returns `defaultYes` (defaults to true) without blocking.
+ * In TTY, waits for a single keypress: y/Enter → true, n/Esc/q → false.
+ */
+export declare function confirmPrompt(message: string, defaultYes?: boolean): Promise<boolean>;

package/dist/tui.js

@@ -138,3 +138,55 @@ export async function checkboxPrompt(items, opts = {}) {
         draw();
     });
 }
+/**
+ * Simple yes/no confirmation prompt.
+ *
+ * In non-TTY environments, returns `defaultYes` (defaults to true) without blocking.
+ * In TTY, waits for a single keypress: y/Enter → true, n/Esc/q → false.
+ */
+export async function confirmPrompt(message, defaultYes = true) {
+    const { stdin, stdout } = process;
+    if (!stdin.isTTY)
+        return defaultYes;
+    const hint = defaultYes ? '[Y/n]' : '[y/N]';
+    stdout.write(`  ${message} ${chalk.dim(hint)} `);
+    return new Promise((resolve) => {
+        const wasRaw = stdin.isRaw;
+        stdin.setRawMode(true);
+        stdin.resume();
+        function cleanup() {
+            stdin.setRawMode(wasRaw ?? false);
+            stdin.pause();
+            stdin.removeListener('data', onData);
+            stdout.write('\n');
+        }
+        function onData(data) {
+            const key = data.toString();
+            // Ctrl+C
+            if (key === '\x03') {
+                cleanup();
+                process.exit(EXIT_CODES.INTERRUPTED);
+            }
+            // Enter — use default
+            if (key === '\r' || key === '\n') {
+                cleanup();
+                resolve(defaultYes);
+                return;
+            }
+            // y/Y — yes
+            if (key === 'y' || key === 'Y') {
+                cleanup();
+                resolve(true);
+                return;
+            }
+            // n/N/q/Esc — no
+            if (key === 'n' || key === 'N' || key === 'q' || key === '\x1b') {
+                cleanup();
+                resolve(false);
+                return;
+            }
+            // Ignore other keys
+        }
+        stdin.on('data', onData);
+    });
+}

package/dist/tui.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tui.test.js

@@ -0,0 +1,19 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { confirmPrompt } from './tui.js';
+describe('confirmPrompt', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('returns defaultYes when stdin is not TTY', async () => {
+        const result = await confirmPrompt('Restart?', true);
+        expect(result).toBe(true);
+    });
+    it('returns false when defaultYes is false and non-TTY', async () => {
+        const result = await confirmPrompt('Restart?', false);
+        expect(result).toBe(false);
+    });
+    it('defaults to true when defaultYes is omitted and non-TTY', async () => {
+        const result = await confirmPrompt('Restart?');
+        expect(result).toBe(true);
+    });
+});

package/dist/weixin-download.test.js

@@ -27,4 +27,18 @@ describe('weixin publish time extraction', () => {
         const extractInPage = eval(mod.buildExtractWechatPublishTimeJs());
         expect(extractInPage('2026年3月24日 22:38', 'var create_time = "1711291080";')).toBe('2026年3月24日 22:38');
     });
+    it('detects WeChat verification gate pages', async () => {
+        const mod = await loadModule();
+        expect(mod.detectWechatAccessIssue('环境异常 当前环境异常，完成验证后即可继续访问。 去验证', '<html><body><a id="js_verify">去验证</a></body></html>')).toBe('environment verification required');
+    });
+    it('browser access detector matches the server-side verifier', async () => {
+        const mod = await loadModule();
+        const detectInPage = eval(mod.buildDetectWechatAccessIssueJs());
+        expect(detectInPage('环境异常 当前环境异常，完成验证后即可继续访问。 去验证', '<html>secitptpage/verify.html<a id="js_verify">去验证</a></html>')).toBe('environment verification required');
+    });
+    it('picks the first non-empty WeChat metadata field', async () => {
+        const mod = await loadModule();
+        expect(mod.pickFirstWechatMetaText('', 'Name cleared', '数字生命卡兹克')).toBe('数字生命卡兹克');
+        expect(mod.pickFirstWechatMetaText('', '  聊聊刚刚上线的PixVerse V6视频模型。  ')).toBe('聊聊刚刚上线的PixVerse V6视频模型。');
+    });
 });

package/docs/.vitepress/config.mts

@@ -72,6 +72,7 @@ export default defineConfig({
                 { text: 'Band', link: '/adapters/browser/band' },
                 { text: 'Chaoxing', link: '/adapters/browser/chaoxing' },
                 { text: 'Grok', link: '/adapters/browser/grok' },
+                { text: 'NotebookLM', link: '/adapters/browser/notebooklm' },
                 { text: 'WeRead', link: '/adapters/browser/weread' },
                 { text: 'Douban', link: '/adapters/browser/douban' },
                 { text: 'Sina Blog', link: '/adapters/browser/sinablog' },

package/docs/adapters/browser/notebooklm.md

@@ -0,0 +1,69 @@
+# NotebookLM
+
+**Mode**: 🔐 Browser Bridge · **Domain**: `notebooklm.google.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `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 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 |
+| `opencli notebooklm source-fulltext <source>` | Fetch extracted source fulltext through NotebookLM RPC |
+| `opencli notebooklm source-guide <source>` | Fetch guide summary and keywords for one source |
+| `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 metadata` | `opencli notebooklm get` |
+| `opencli notebooklm use` | `opencli notebooklm bind-current` |
+| `opencli notebooklm notes-list` | `opencli notebooklm note-list` |
+
+## Positioning
+
+This adapter reuses the existing OpenCLI Browser Bridge runtime:
+
+- no custom NotebookLM extension
+- no exported cookie replay
+- requests and page state stay in the real Chrome session
+
+The current milestone focuses on a stable NotebookLM read surface in desktop Chrome with an already logged-in Google account.
+
+## Usage Examples
+
+```bash
+opencli notebooklm status
+opencli notebooklm list -f json
+opencli notebooklm current -f json
+opencli notebooklm metadata -f json
+opencli notebooklm source-list -f json
+opencli notebooklm source-get "Quarterly report" -f json
+opencli notebooklm source-guide "Quarterly report" -f json
+opencli notebooklm source-fulltext "Quarterly report" -f json
+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
+
+- Chrome running and logged into Google / NotebookLM
+- [Browser Bridge extension](/guide/browser-bridge) installed
+- NotebookLM accessible in the current browser session
+
+## 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`.
+- `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/browser/xiaohongshu.md

@@ -7,15 +7,18 @@
 | Command | Description |
 |---------|-------------|
 | `opencli xiaohongshu search` | Search notes by keyword (returns title, author, likes, URL) |
-| `opencli xiaohongshu notifications` | |
-| `opencli xiaohongshu feed` | |
-| `opencli xiaohongshu user` | |
-| `opencli xiaohongshu download` | |
-| `opencli xiaohongshu creator-notes` | |
-| `opencli xiaohongshu creator-note-detail` | |
-| `opencli xiaohongshu creator-notes-summary` | |
-| `opencli xiaohongshu creator-profile` | |
-| `opencli xiaohongshu creator-stats` | |
+| `opencli xiaohongshu note` | Read full note content (title, author, description, likes, collects, comments, tags) |
+| `opencli xiaohongshu comments` | Read comments from a note (`--with-replies` for nested 楼中楼 replies) |
+| `opencli xiaohongshu feed` | Home feed recommendations (via Pinia store interception) |
+| `opencli xiaohongshu notifications` | User notifications (mentions, likes, connections) |
+| `opencli xiaohongshu user` | Get public notes from a user profile |
+| `opencli xiaohongshu download` | Download images and videos from a note |
+| `opencli xiaohongshu publish` | Publish image-text notes (creator center UI automation) |
+| `opencli xiaohongshu creator-notes` | Creator's note list with per-note metrics |
+| `opencli xiaohongshu creator-note-detail` | Detailed analytics for a single creator note |
+| `opencli xiaohongshu creator-notes-summary` | Combined note list + detail analytics summary |
+| `opencli xiaohongshu creator-profile` | Creator account info (followers, growth level) |
+| `opencli xiaohongshu creator-stats` | Creator data overview (views, likes, collects, trends) |
 
 ## Usage Examples
 
@@ -23,13 +26,19 @@
 # Search for notes
 opencli xiaohongshu search 美食 --limit 10
 
+# Read a note's full content (pass URL from search results to preserve xsec_token)
+opencli xiaohongshu note "https://www.xiaohongshu.com/search_result/<id>?xsec_token=..."
+
+# Read comments with nested replies (楼中楼)
+opencli xiaohongshu comments "https://www.xiaohongshu.com/search_result/<id>?xsec_token=..." --with-replies --limit 20
+
 # JSON output
 opencli xiaohongshu search 旅行 -f json
 
 # Other commands
 opencli xiaohongshu feed
 opencli xiaohongshu notifications
-opencli xiaohongshu download <url>
+opencli xiaohongshu download <note-id or url>
 ```
 
 ## Prerequisites

package/docs/adapters/index.md

@@ -6,79 +6,80 @@ Run `opencli list` for the live registry.
 
 | Site | Commands | Mode |
 |------|----------|------|
-| **[twitter](/adapters/browser/twitter)** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` `block` `unblock` `hide-reply` | 🔐 Browser |
-| **[reddit](/adapters/browser/reddit)** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 🔐 Browser |
-| **[tieba](/adapters/browser/tieba)** | `hot` `posts` `search` `read` | 🔐 Browser |
-| **[bilibili](/adapters/browser/bilibili)** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` `download` | 🔐 Browser |
-| **[zhihu](/adapters/browser/zhihu)** | `hot` `search` `question` `download` | 🔐 Browser |
-| **[xiaohongshu](/adapters/browser/xiaohongshu)** | `search` `notifications` `feed` `user` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | 🔐 Browser |
-| **[xueqiu](/adapters/browser/xueqiu)** | `feed` `hot-stock` `hot` `search` `stock` `comments` `watchlist` `earnings-date` `fund-holdings` `fund-snapshot` | 🔐 Browser |
-| **[youtube](/adapters/browser/youtube)** | `search` `video` `transcript` | 🔐 Browser |
-| **[v2ex](/adapters/browser/v2ex)** | `hot` `latest` `topic` `node` `user` `member` `replies` `nodes` `daily` `me` `notifications` | 🌐 / 🔐 |
-| **[bloomberg](/adapters/browser/bloomberg)** | `main` `markets` `economics` `industries` `tech` `politics` `businessweek` `opinions` `feeds` `news` | 🌐 / 🔐 |
-| **[weibo](/adapters/browser/weibo)** | `hot` `search` | 🔐 Browser |
-| **[linkedin](/adapters/browser/linkedin)** | `search` `timeline` | 🔐 Browser |
-| **[coupang](/adapters/browser/coupang)** | `search` `add-to-cart` | 🔐 Browser |
-| **[boss](/adapters/browser/boss)** | `search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats` | 🔐 Browser |
-| **[ctrip](/adapters/browser/ctrip)** | `search` | 🔐 Browser |
-| **[reuters](/adapters/browser/reuters)** | `search` | 🔐 Browser |
-| **[smzdm](/adapters/browser/smzdm)** | `search` | 🔐 Browser |
-| **[jike](/adapters/browser/jike)** | `feed` `search` `post` `topic` `user` `create` `comment` `like` `repost` `notifications` | 🔐 Browser |
-| **[jimeng](/adapters/browser/jimeng)** | `generate` `history` | 🔐 Browser |
-| **[yollomi](/adapters/browser/yollomi)** | `generate` `video` `edit` `upload` `models` `remove-bg` `upscale` `face-swap` `restore` `try-on` `background` `object-remover` | 🔐 Browser |
-| **[linux-do](/adapters/browser/linux-do)** | `feed` `categories` `tags` `search` `topic` `user-topics` `user-posts` | 🔐 Browser |
-| **[chaoxing](/adapters/browser/chaoxing)** | `assignments` `exams` | 🔐 Browser |
-| **[grok](/adapters/browser/grok)** | `ask` | 🔐 Browser |
-| **[doubao](/adapters/browser/doubao)** | `status` `new` `send` `read` `ask` `history` `detail` `meeting-summary` `meeting-transcript` | 🔐 Browser |
-| **[weread](/adapters/browser/weread)** | `shelf` `search` `book` `ranking` `notebooks` `highlights` `notes` | 🔐 Browser |
-| **[douban](/adapters/browser/douban)** | `search` `top250` `subject` `photos` `download` `marks` `reviews` `movie-hot` `book-hot` | 🔐 Browser |
-| **[facebook](/adapters/browser/facebook)** | `feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group` | 🔐 Browser |
-| **[imdb](/adapters/browser/imdb)** | `search` `title` `top` `trending` `person` `reviews` | 🌐 / 🔐 |
-| **[instagram](/adapters/browser/instagram)** | `explore` `profile` `search` `user` `followers` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `saved` | 🔐 Browser |
-| **[medium](/adapters/browser/medium)** | `feed` `search` `user` | 🔐 Browser |
-| **[sinablog](/adapters/browser/sinablog)** | `hot` `search` `article` `user` | 🔐 Browser |
-| **[substack](/adapters/browser/substack)** | `feed` `search` `publication` | 🔐 Browser |
-| **[pixiv](/adapters/browser/pixiv)** | `ranking` `search` `user` `illusts` `detail` `download` | 🔐 Browser |
-| **[tiktok](/adapters/browser/tiktok)** | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` | 🔐 Browser |
-| **[google](/adapters/browser/google)** | `news` `search` `suggest` `trends` | 🌐 / 🔐 |
-| **[jd](/adapters/browser/jd)** | `item` | 🔐 Browser |
-| **[web](/adapters/browser/web)** | `read` | 🔐 Browser |
-| **[weixin](/adapters/browser/weixin)** | `download` | 🔐 Browser |
-| **[36kr](/adapters/browser/36kr)** | `news` `hot` `search` `article` | 🌐 / 🔐 |
-| **[producthunt](/adapters/browser/producthunt)** | `posts` `today` `hot` `browse` | 🌐 / 🔐 |
-| **[ones](/adapters/browser/ones)** | `login` `me` `token-info` `tasks` `my-tasks` `task` `worklog` `logout` | 🔐 Browser Bridge + `ONES_BASE_URL` |
+| **[twitter](./browser/twitter)** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` `block` `unblock` `hide-reply` | 🔐 Browser |
+| **[reddit](./browser/reddit)** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 🔐 Browser |
+| **[tieba](./browser/tieba)** | `hot` `posts` `search` `read` | 🔐 Browser |
+| **[bilibili](./browser/bilibili)** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` `download` | 🔐 Browser |
+| **[zhihu](./browser/zhihu)** | `hot` `search` `question` `download` | 🔐 Browser |
+| **[xiaohongshu](./browser/xiaohongshu)** | `search` `notifications` `feed` `user` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | 🔐 Browser |
+| **[xueqiu](./browser/xueqiu)** | `feed` `hot-stock` `hot` `search` `stock` `comments` `watchlist` `earnings-date` `fund-holdings` `fund-snapshot` | 🔐 Browser |
+| **[youtube](./browser/youtube)** | `search` `video` `transcript` | 🔐 Browser |
+| **[v2ex](./browser/v2ex)** | `hot` `latest` `topic` `node` `user` `member` `replies` `nodes` `daily` `me` `notifications` | 🌐 / 🔐 |
+| **[bloomberg](./browser/bloomberg)** | `main` `markets` `economics` `industries` `tech` `politics` `businessweek` `opinions` `feeds` `news` | 🌐 / 🔐 |
+| **[weibo](./browser/weibo)** | `hot` `search` | 🔐 Browser |
+| **[linkedin](./browser/linkedin)** | `search` `timeline` | 🔐 Browser |
+| **[coupang](./browser/coupang)** | `search` `add-to-cart` | 🔐 Browser |
+| **[boss](./browser/boss)** | `search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats` | 🔐 Browser |
+| **[ctrip](./browser/ctrip)** | `search` | 🔐 Browser |
+| **[reuters](./browser/reuters)** | `search` | 🔐 Browser |
+| **[smzdm](./browser/smzdm)** | `search` | 🔐 Browser |
+| **[jike](./browser/jike)** | `feed` `search` `post` `topic` `user` `create` `comment` `like` `repost` `notifications` | 🔐 Browser |
+| **[jimeng](./browser/jimeng)** | `generate` `history` | 🔐 Browser |
+| **[yollomi](./browser/yollomi)** | `generate` `video` `edit` `upload` `models` `remove-bg` `upscale` `face-swap` `restore` `try-on` `background` `object-remover` | 🔐 Browser |
+| **[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 |
+| **[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 |
+| **[facebook](./browser/facebook)** | `feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group` | 🔐 Browser |
+| **[imdb](./browser/imdb)** | `search` `title` `top` `trending` `person` `reviews` | 🌐 / 🔐 |
+| **[instagram](./browser/instagram)** | `explore` `profile` `search` `user` `followers` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `saved` | 🔐 Browser |
+| **[medium](./browser/medium)** | `feed` `search` `user` | 🔐 Browser |
+| **[sinablog](./browser/sinablog)** | `hot` `search` `article` `user` | 🔐 Browser |
+| **[substack](./browser/substack)** | `feed` `search` `publication` | 🔐 Browser |
+| **[pixiv](./browser/pixiv)** | `ranking` `search` `user` `illusts` `detail` `download` | 🔐 Browser |
+| **[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 |
+| **[web](./browser/web)** | `read` | 🔐 Browser |
+| **[weixin](./browser/weixin)** | `download` | 🔐 Browser |
+| **[36kr](./browser/36kr)** | `news` `hot` `search` `article` | 🌐 / 🔐 |
+| **[producthunt](./browser/producthunt)** | `posts` `today` `hot` `browse` | 🌐 / 🔐 |
+| **[ones](./browser/ones)** | `login` `me` `token-info` `tasks` `my-tasks` `task` `worklog` `logout` | 🔐 Browser Bridge + `ONES_BASE_URL` |
 
 ## Public API Adapters
 
 | Site | Commands | Mode |
 |------|----------|------|
-| **[hackernews](/adapters/browser/hackernews)** | `top` `new` `best` `ask` `show` `jobs` `search` `user` | 🌐 Public |
-| **[bbc](/adapters/browser/bbc)** | `news` | 🌐 Public |
-| **[devto](/adapters/browser/devto)** | `top` `tag` `user` | 🌐 Public |
-| **[dictionary](/adapters/browser/dictionary)** | `search` `synonyms` `examples` | 🌐 Public |
-| **[apple-podcasts](/adapters/browser/apple-podcasts)** | `search` `episodes` `top` | 🌐 Public |
-| **[xiaoyuzhou](/adapters/browser/xiaoyuzhou)** | `podcast` `podcast-episodes` `episode` | 🌐 Public |
-| **[yahoo-finance](/adapters/browser/yahoo-finance)** | `quote` | 🌐 Public |
-| **[arxiv](/adapters/browser/arxiv)** | `search` `paper` | 🌐 Public |
-| **[paperreview](/adapters/browser/paperreview)** | `submit` `review` `feedback` | 🌐 Public |
-| **[barchart](/adapters/browser/barchart)** | `quote` `options` `greeks` `flow` | 🌐 Public |
-| **[hf](/adapters/browser/hf)** | `top` | 🌐 Public |
-| **[sinafinance](/adapters/browser/sinafinance)** | `news` | 🌐 Public |
-| **[spotify](/adapters/browser/spotify)** | `auth` `status` `play` `pause` `next` `prev` `volume` `search` `queue` `shuffle` `repeat` | 🔑 OAuth API |
-| **[stackoverflow](/adapters/browser/stackoverflow)** | `hot` `search` `bounties` `unanswered` | 🌐 Public |
-| **[wikipedia](/adapters/browser/wikipedia)** | `search` `summary` `random` `trending` | 🌐 Public |
-| **[lobsters](/adapters/browser/lobsters)** | `hot` `newest` `active` `tag` | 🌐 Public |
-| **[steam](/adapters/browser/steam)** | `top-sellers` | 🌐 Public |
+| **[hackernews](./browser/hackernews)** | `top` `new` `best` `ask` `show` `jobs` `search` `user` | 🌐 Public |
+| **[bbc](./browser/bbc)** | `news` | 🌐 Public |
+| **[devto](./browser/devto)** | `top` `tag` `user` | 🌐 Public |
+| **[dictionary](./browser/dictionary)** | `search` `synonyms` `examples` | 🌐 Public |
+| **[apple-podcasts](./browser/apple-podcasts)** | `search` `episodes` `top` | 🌐 Public |
+| **[xiaoyuzhou](./browser/xiaoyuzhou)** | `podcast` `podcast-episodes` `episode` | 🌐 Public |
+| **[yahoo-finance](./browser/yahoo-finance)** | `quote` | 🌐 Public |
+| **[arxiv](./browser/arxiv)** | `search` `paper` | 🌐 Public |
+| **[paperreview](./browser/paperreview)** | `submit` `review` `feedback` | 🌐 Public |
+| **[barchart](./browser/barchart)** | `quote` `options` `greeks` `flow` | 🌐 Public |
+| **[hf](./browser/hf)** | `top` | 🌐 Public |
+| **[sinafinance](./browser/sinafinance)** | `news` | 🌐 Public |
+| **[spotify](./browser/spotify)** | `auth` `status` `play` `pause` `next` `prev` `volume` `search` `queue` `shuffle` `repeat` | 🔑 OAuth API |
+| **[stackoverflow](./browser/stackoverflow)** | `hot` `search` `bounties` `unanswered` | 🌐 Public |
+| **[wikipedia](./browser/wikipedia)** | `search` `summary` `random` `trending` | 🌐 Public |
+| **[lobsters](./browser/lobsters)** | `hot` `newest` `active` `tag` | 🌐 Public |
+| **[steam](./browser/steam)** | `top-sellers` | 🌐 Public |
 
 ## Desktop Adapters
 
 | App | Description | Commands |
 |-----|-------------|----------|
-| **[Cursor](/adapters/desktop/cursor)** | Control Cursor IDE | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` |
-| **[Codex](/adapters/desktop/codex)** | Drive OpenAI Codex CLI agent | `status` `send` `read` `new` `extract-diff` `model` `ask` `screenshot` `history` `export` |
-| **[Antigravity](/adapters/desktop/antigravity)** | Control Antigravity Ultra | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` |
-| **[ChatGPT](/adapters/desktop/chatgpt)** | Automate ChatGPT macOS app | `status` `new` `send` `read` `ask` |
-| **[ChatWise](/adapters/desktop/chatwise)** | Multi-LLM client | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` |
-| **[Notion](/adapters/desktop/notion)** | Search, read, write pages | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` |
-| **[Discord](/adapters/desktop/discord)** | Desktop messages & channels | `status` `send` `read` `channels` `servers` `search` `members` |
-| **[Doubao App](/adapters/desktop/doubao-app)** | Doubao AI desktop app via CDP | `status` `new` `send` `read` `ask` `screenshot` `dump` |
+| **[Cursor](./desktop/cursor)** | Control Cursor IDE | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` |
+| **[Codex](./desktop/codex)** | Drive OpenAI Codex CLI agent | `status` `send` `read` `new` `extract-diff` `model` `ask` `screenshot` `history` `export` |
+| **[Antigravity](./desktop/antigravity)** | Control Antigravity Ultra | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` |
+| **[ChatGPT](./desktop/chatgpt)** | Automate ChatGPT macOS app | `status` `new` `send` `read` `ask` |
+| **[ChatWise](./desktop/chatwise)** | Multi-LLM client | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` |
+| **[Notion](./desktop/notion)** | Search, read, write pages | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` |
+| **[Discord](./desktop/discord)** | Desktop messages & channels | `status` `send` `read` `channels` `servers` `search` `members` |
+| **[Doubao App](./desktop/doubao-app)** | Doubao AI desktop app via CDP | `status` `new` `send` `read` `ask` `screenshot` `dump` |

package/docs/guide/browser-bridge.md

@@ -35,3 +35,15 @@ opencli doctor            # Check extension + daemon connectivity
 ```
 
 The daemon manages the WebSocket connection between your CLI commands and the Chrome extension. The extension executes JavaScript in the context of web pages, with access to the logged-in session.
+
+## Daemon Lifecycle
+
+The daemon auto-starts on first browser command and stays alive for **4 hours** by default. It exits only when both conditions are met: no CLI requests for the timeout period AND no Chrome extension connected.
+
+```bash
+opencli daemon status    # Check daemon state (PID, uptime, extension, memory)
+opencli daemon stop      # Graceful shutdown
+opencli daemon restart   # Stop + restart
+```
+
+Override the timeout via the `OPENCLI_DAEMON_TIMEOUT` environment variable (milliseconds). Set to `0` to keep the daemon alive indefinitely.