@jackwener/opencli 1.5.7 → 1.5.9

package/src/clis/notebooklm/open.test.ts

@@ -0,0 +1,78 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const {
+  mockGetNotebooklmPageState,
+  mockReadCurrentNotebooklm,
+  mockRequireNotebooklmSession,
+} = vi.hoisted(() => ({
+  mockGetNotebooklmPageState: vi.fn(),
+  mockReadCurrentNotebooklm: vi.fn(),
+  mockRequireNotebooklmSession: vi.fn(),
+}));
+
+vi.mock('./utils.js', async () => {
+  const actual = await vi.importActual<typeof import('./utils.js')>('./utils.js');
+  return {
+    ...actual,
+    getNotebooklmPageState: mockGetNotebooklmPageState,
+    readCurrentNotebooklm: mockReadCurrentNotebooklm,
+    requireNotebooklmSession: mockRequireNotebooklmSession,
+  };
+});
+
+import { getRegistry } from '../../registry.js';
+import './open.js';
+
+describe('notebooklm open', () => {
+  const command = getRegistry().get('notebooklm/open');
+
+  beforeEach(() => {
+    mockGetNotebooklmPageState.mockReset();
+    mockReadCurrentNotebooklm.mockReset();
+    mockRequireNotebooklmSession.mockReset();
+    mockRequireNotebooklmSession.mockResolvedValue(undefined);
+    mockGetNotebooklmPageState.mockResolvedValue({
+      url: 'https://notebooklm.google.com/notebook/nb-demo',
+      title: 'Browser Automation',
+      hostname: 'notebooklm.google.com',
+      kind: 'notebook',
+      notebookId: 'nb-demo',
+      loginRequired: false,
+      notebookCount: 1,
+    });
+    mockReadCurrentNotebooklm.mockResolvedValue({
+      id: 'nb-demo',
+      title: 'Browser Automation',
+      url: 'https://notebooklm.google.com/notebook/nb-demo',
+      source: 'current-page',
+    });
+  });
+
+  it('opens a notebook by id in the automation workspace', async () => {
+    const page = {
+      goto: vi.fn(async () => {}),
+      wait: vi.fn(async () => {}),
+    };
+
+    const result = await command!.func!(page as any, { notebook: 'nb-demo' });
+
+    expect(page.goto).toHaveBeenCalledWith('https://notebooklm.google.com/notebook/nb-demo');
+    expect(result).toEqual([{
+      id: 'nb-demo',
+      title: 'Browser Automation',
+      url: 'https://notebooklm.google.com/notebook/nb-demo',
+      source: 'current-page',
+    }]);
+  });
+
+  it('accepts a full notebook url', async () => {
+    const page = {
+      goto: vi.fn(async () => {}),
+      wait: vi.fn(async () => {}),
+    };
+
+    await command!.func!(page as any, { notebook: 'https://notebooklm.google.com/notebook/nb-demo?pli=1' });
+
+    expect(page.goto).toHaveBeenCalledWith('https://notebooklm.google.com/notebook/nb-demo');
+  });
+});

package/src/clis/notebooklm/open.ts

@@ -0,0 +1,61 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+import { CliError, EmptyResultError } from '../../errors.js';
+import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
+import {
+  buildNotebooklmNotebookUrl,
+  getNotebooklmPageState,
+  parseNotebooklmNotebookTarget,
+  readCurrentNotebooklm,
+  requireNotebooklmSession,
+} from './utils.js';
+
+cli({
+  site: NOTEBOOKLM_SITE,
+  name: 'open',
+  aliases: ['select'],
+  description: 'Open one NotebookLM notebook in the automation workspace by id or URL',
+  domain: NOTEBOOKLM_DOMAIN,
+  strategy: Strategy.COOKIE,
+  browser: true,
+  navigateBefore: false,
+  args: [
+    {
+      name: 'notebook',
+      positional: true,
+      required: true,
+      help: 'Notebook id from list output, or a full NotebookLM notebook URL',
+    },
+  ],
+  columns: ['id', 'title', 'url', 'source'],
+  func: async (page: IPage, kwargs) => {
+    const notebookId = parseNotebooklmNotebookTarget(String(kwargs.notebook ?? ''));
+    await page.goto(buildNotebooklmNotebookUrl(notebookId));
+    await page.wait(2);
+    await requireNotebooklmSession(page);
+
+    const state = await getNotebooklmPageState(page);
+    if (state.kind !== 'notebook') {
+      throw new CliError(
+        'NOTEBOOKLM_OPEN_FAILED',
+        `NotebookLM notebook "${notebookId}" did not open in the automation workspace`,
+        'Run `opencli notebooklm list -f json` first and pass a valid notebook id.',
+      );
+    }
+    if (state.notebookId !== notebookId) {
+      console.warn(
+        `[notebooklm open] expected notebook "${notebookId}" but page reports "${state.notebookId}"; continuing`,
+      );
+    }
+
+    const current = await readCurrentNotebooklm(page);
+    if (!current) {
+      throw new EmptyResultError(
+        'opencli notebooklm open',
+        'NotebookLM notebook metadata was not found after navigation.',
+      );
+    }
+
+    return [current];
+  },
+});

package/src/clis/notebooklm/source-fulltext.ts

@@ -3,7 +3,6 @@ import type { IPage } from '../../types.js';
 import { EmptyResultError } from '../../errors.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
 import {
-  ensureNotebooklmNotebookBinding,
   findNotebooklmSourceRow,
   getNotebooklmPageState,
   getNotebooklmSourceFulltextViaRpc,
@@ -30,13 +29,12 @@ cli({
   ],
   columns: ['title', 'kind', 'char_count', 'url', 'source'],
   func: async (page: IPage, kwargs) => {
-    await ensureNotebooklmNotebookBinding(page);
     await requireNotebooklmSession(page);
     const state = await getNotebooklmPageState(page);
     if (state.kind !== 'notebook') {
       throw new EmptyResultError(
         'opencli notebooklm source-fulltext',
-        'Open a specific NotebookLM notebook tab first, then retry.',
+        'No NotebookLM notebook is open in the automation workspace. Run `opencli notebooklm open <notebook>` first.',
       );
     }
 

package/src/clis/notebooklm/source-get.ts

@@ -3,7 +3,6 @@ import type { IPage } from '../../types.js';
 import { EmptyResultError } from '../../errors.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
 import {
-  ensureNotebooklmNotebookBinding,
   findNotebooklmSourceRow,
   getNotebooklmPageState,
   listNotebooklmSourcesFromPage,
@@ -29,13 +28,12 @@ cli({
   ],
   columns: ['title', 'id', 'type', 'size', 'created_at', 'updated_at', 'url', 'source'],
   func: async (page: IPage, kwargs) => {
-    await ensureNotebooklmNotebookBinding(page);
     await requireNotebooklmSession(page);
     const state = await getNotebooklmPageState(page);
     if (state.kind !== 'notebook') {
       throw new EmptyResultError(
         'opencli notebooklm source-get',
-        'Open a specific NotebookLM notebook tab first, then retry.',
+        'No NotebookLM notebook is open in the automation workspace. Run `opencli notebooklm open <notebook>` first.',
       );
     }
 

package/src/clis/notebooklm/source-guide.ts

@@ -3,7 +3,6 @@ import type { IPage } from '../../types.js';
 import { EmptyResultError } from '../../errors.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
 import {
-  ensureNotebooklmNotebookBinding,
   findNotebooklmSourceRow,
   getNotebooklmPageState,
   getNotebooklmSourceGuideViaRpc,
@@ -30,13 +29,12 @@ cli({
   ],
   columns: ['source_id', 'notebook_id', 'title', 'type', 'summary', 'keywords', 'source'],
   func: async (page: IPage, kwargs) => {
-    await ensureNotebooklmNotebookBinding(page);
     await requireNotebooklmSession(page);
     const state = await getNotebooklmPageState(page);
     if (state.kind !== 'notebook') {
       throw new EmptyResultError(
         'opencli notebooklm source-guide',
-        'Open a specific NotebookLM notebook tab first, then retry.',
+        'No NotebookLM notebook is open in the automation workspace. Run `opencli notebooklm open <notebook>` first.',
       );
     }
 

package/src/clis/notebooklm/source-list.ts

@@ -3,7 +3,6 @@ import type { IPage } from '../../types.js';
 import { EmptyResultError } from '../../errors.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
 import {
-  ensureNotebooklmNotebookBinding,
   getNotebooklmPageState,
   listNotebooklmSourcesFromPage,
   listNotebooklmSourcesViaRpc,
@@ -21,13 +20,12 @@ cli({
   args: [],
   columns: ['title', 'id', 'type', 'size', 'created_at', 'updated_at', 'url', 'source'],
   func: async (page: IPage) => {
-    await ensureNotebooklmNotebookBinding(page);
     await requireNotebooklmSession(page);
     const state = await getNotebooklmPageState(page);
     if (state.kind !== 'notebook') {
       throw new EmptyResultError(
         'opencli notebooklm source-list',
-        'Open a specific NotebookLM notebook tab first, then retry.',
+        'No NotebookLM notebook is open in the automation workspace. Run `opencli notebooklm open <notebook>` first.',
       );
     }
 

package/src/clis/notebooklm/status.ts

@@ -1,7 +1,7 @@
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_HOME_URL, NOTEBOOKLM_SITE } from './shared.js';
-import { ensureNotebooklmNotebookBinding, getNotebooklmPageState } from './utils.js';
+import { getNotebooklmPageState } from './utils.js';
 
 cli({
   site: NOTEBOOKLM_SITE,
@@ -14,7 +14,6 @@ cli({
   args: [],
   columns: ['status', 'login', 'page', 'url', 'title', 'notebooks'],
   func: async (page: IPage) => {
-    await ensureNotebooklmNotebookBinding(page);
     const currentUrl = await page.getCurrentUrl?.().catch(() => null);
     if (!currentUrl || !currentUrl.includes(NOTEBOOKLM_DOMAIN)) {
       await page.goto(NOTEBOOKLM_HOME_URL);

package/src/clis/notebooklm/summary.ts

@@ -3,7 +3,6 @@ import type { IPage } from '../../types.js';
 import { EmptyResultError } from '../../errors.js';
 import { NOTEBOOKLM_DOMAIN, NOTEBOOKLM_SITE } from './shared.js';
 import {
-  ensureNotebooklmNotebookBinding,
   getNotebooklmPageState,
   getNotebooklmSummaryViaRpc,
   readNotebooklmSummaryFromPage,
@@ -21,13 +20,12 @@ cli({
   args: [],
   columns: ['title', 'summary', 'source', 'url'],
   func: async (page: IPage) => {
-    await ensureNotebooklmNotebookBinding(page);
     await requireNotebooklmSession(page);
     const state = await getNotebooklmPageState(page);
     if (state.kind !== 'notebook') {
       throw new EmptyResultError(
         'opencli notebooklm summary',
-        'Open a specific NotebookLM notebook tab first, then retry.',
+        'No NotebookLM notebook is open in the automation workspace. Run `opencli notebooklm open <notebook>` first.',
       );
     }
 

package/src/clis/notebooklm/utils.ts

@@ -1,10 +1,8 @@
 import { AuthRequiredError, CliError } from '../../errors.js';
 import type { IPage } from '../../types.js';
-import { bindCurrentTab } from '../../browser/daemon-client.js';
 import {
   NOTEBOOKLM_DOMAIN,
   NOTEBOOKLM_HOME_URL,
-  NOTEBOOKLM_SITE,
   type NotebooklmHistoryRow,
   type NotebooklmNotebookDetailRow,
   type NotebooklmNoteDetailRow,
@@ -54,6 +52,35 @@ export function parseNotebooklmIdFromUrl(url: string): string {
   return match?.[1] ?? '';
 }
 
+export function parseNotebooklmNotebookTarget(value: string): string {
+  const normalized = value.trim();
+  if (!normalized) {
+    throw new CliError(
+      'NOTEBOOKLM_INVALID_NOTEBOOK',
+      'NotebookLM notebook id is required',
+      'Pass a notebook id from `opencli notebooklm list` or a full notebook URL.',
+    );
+  }
+
+  if (/^https?:\/\//i.test(normalized)) {
+    const notebookId = parseNotebooklmIdFromUrl(normalized);
+    if (notebookId) return notebookId;
+    throw new CliError(
+      'NOTEBOOKLM_INVALID_NOTEBOOK',
+      'NotebookLM notebook URL is invalid',
+      'Pass a full NotebookLM notebook URL like https://notebooklm.google.com/notebook/<id>.',
+    );
+  }
+
+  const pathMatch = normalized.match(/(?:^|\/)notebook\/([^/?#]+)/);
+  if (pathMatch?.[1]) return pathMatch[1];
+  return normalized;
+}
+
+export function buildNotebooklmNotebookUrl(notebookId: string): string {
+  return new URL(`/notebook/${encodeURIComponent(notebookId)}`, NOTEBOOKLM_HOME_URL).toString();
+}
+
 export function classifyNotebooklmPage(url: string): NotebooklmPageKind {
   try {
     const parsed = new URL(url);
@@ -656,24 +683,6 @@ export async function ensureNotebooklmHome(page: IPage): Promise<void> {
   await page.wait(2);
 }
 
-export async function ensureNotebooklmNotebookBinding(page: IPage): Promise<boolean> {
-  if (!page.getCurrentUrl) return false;
-  if (process.env.OPENCLI_CDP_ENDPOINT) return false;
-
-  const currentUrl = await page.getCurrentUrl().catch(() => null);
-  if (currentUrl && classifyNotebooklmPage(currentUrl) === 'notebook') return false;
-
-  try {
-    await bindCurrentTab(`site:${NOTEBOOKLM_SITE}`, {
-      matchDomain: NOTEBOOKLM_DOMAIN,
-      matchPathPrefix: '/notebook/',
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 export async function getNotebooklmPageState(page: IPage): Promise<NotebooklmPageState> {
   const raw = await page.evaluate(`(() => {
     const url = window.location.href;

package/src/clis/xiaohongshu/creator-note-detail.test.ts

@@ -40,9 +40,9 @@ function createPageMock(evaluateResult: any): IPage {
 describe('xiaohongshu creator-note-detail', () => {
   it('parses note detail page text into info and metric rows', () => {
     const bodyText = `笔记数据详情
-一张图讲清 诡秘之主·耕种者途径
-#诡秘之主
-#耕种者序列
+示例内容复盘
+#测试标签
+#内容分析
 2026-03-18 20:01
 切换笔记
 笔记诊断
@@ -86,9 +86,9 @@ describe('xiaohongshu creator-note-detail', () => {
 6
 粉丝占比 0%`;
 
-    expect(parseCreatorNoteDetailText(bodyText, '69ba940500000000200384db')).toEqual([
-      { section: '笔记信息', metric: 'note_id', value: '69ba940500000000200384db', extra: '' },
-      { section: '笔记信息', metric: 'title', value: '一张图讲清 诡秘之主·耕种者途径', extra: '' },
+    expect(parseCreatorNoteDetailText(bodyText, 'cccccccccccccccccccccccc')).toEqual([
+      { section: '笔记信息', metric: 'note_id', value: 'cccccccccccccccccccccccc', extra: '' },
+      { section: '笔记信息', metric: 'title', value: '示例内容复盘', extra: '' },
       { section: '笔记信息', metric: 'published_at', value: '2026-03-18 20:01', extra: '' },
       { section: '基础数据', metric: '曝光数', value: '1733', extra: '粉丝占比 6.6%' },
       { section: '基础数据', metric: '观看数', value: '544', extra: '粉丝占比 7.2%' },
@@ -104,8 +104,8 @@ describe('xiaohongshu creator-note-detail', () => {
 
   it('parses structured note detail dom data into rows', () => {
     expect(parseCreatorNoteDetailDomData({
-      title: '神雕侠侣战力金字塔',
-      infoText: '神雕侠侣战力金字塔\n#武侠\n2025-12-04 19:45\n切换笔记',
+      title: '测试笔记一',
+      infoText: '测试笔记一\n#测试标签\n2025-12-04 19:45\n切换笔记',
       sections: [
         {
           title: '基础数据',
@@ -127,9 +127,9 @@ describe('xiaohongshu creator-note-detail', () => {
           ],
         },
       ],
-    }, '693155fc000000000d03b42c')).toEqual([
-      { section: '笔记信息', metric: 'note_id', value: '693155fc000000000d03b42c', extra: '' },
-      { section: '笔记信息', metric: 'title', value: '神雕侠侣战力金字塔', extra: '' },
+    }, 'bbbbbbbbbbbbbbbbbbbbbbbb')).toEqual([
+      { section: '笔记信息', metric: 'note_id', value: 'bbbbbbbbbbbbbbbbbbbbbbbb', extra: '' },
+      { section: '笔记信息', metric: 'title', value: '测试笔记一', extra: '' },
       { section: '笔记信息', metric: 'published_at', value: '2025-12-04 19:45', extra: '' },
       { section: '基础数据', metric: '曝光数', value: '898204', extra: '粉丝占比 0.5%' },
       { section: '基础数据', metric: '观看数', value: '148284', extra: '粉丝占比 0.6%' },

package/src/clis/xiaohongshu/creator-notes-summary.test.ts

@@ -7,14 +7,14 @@ import './creator-notes-summary.js';
 describe('xiaohongshu creator-notes-summary', () => {
   it('summarizes note list row and detail rows into one compact row', () => {
     const note: CreatorNoteRow = {
-      id: '69ba940500000000200384db',
-      title: '一张图讲清 诡秘之主·耕种者途径',
+      id: 'cccccccccccccccccccccccc',
+      title: '示例内容复盘',
       date: '2026年03月18日 20:01',
       views: 549,
       likes: 19,
       collects: 10,
       comments: 7,
-      url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+      url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=cccccccccccccccccccccccc',
     };
 
     const rows: CreatorNoteDetailRow[] = [
@@ -34,8 +34,8 @@ describe('xiaohongshu creator-notes-summary', () => {
 
     expect(summarizeCreatorNote(note, rows, 1)).toEqual({
       rank: 1,
-      id: '69ba940500000000200384db',
-      title: '一张图讲清 诡秘之主·耕种者途径',
+      id: 'cccccccccccccccccccccccc',
+      title: '示例内容复盘',
       published_at: '2026-03-18 20:01',
       views: '549',
       likes: '19',
@@ -48,7 +48,7 @@ describe('xiaohongshu creator-notes-summary', () => {
       top_source_pct: '89.9%',
       top_interest: '二次元',
       top_interest_pct: '13%',
-      url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+      url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=cccccccccccccccccccccccc',
     });
   });
 });

package/src/clis/xiaohongshu/creator-notes.test.ts

@@ -46,7 +46,7 @@ describe('xiaohongshu creator-notes', () => {
     const bodyText = `笔记管理
 全部笔记(366)
 已发布
-神雕侠侣战力金字塔
+测试笔记一
 发布于 2025年12月04日 19:45
 148208
 324
@@ -58,7 +58,7 @@ describe('xiaohongshu creator-notes', () => {
 编辑
 删除
 仅自己可见
-终于等到了！！！
+测试笔记二
 发布于 2026年03月18日 12:39
 10
 0
@@ -70,7 +70,7 @@ describe('xiaohongshu creator-notes', () => {
     expect(parseCreatorNotesText(bodyText)).toEqual([
       {
         id: '',
-        title: '神雕侠侣战力金字塔',
+        title: '测试笔记一',
         date: '2025年12月04日 19:45',
         views: 148208,
         likes: 2279,
@@ -80,7 +80,7 @@ describe('xiaohongshu creator-notes', () => {
       },
       {
         id: '',
-        title: '终于等到了！！！',
+        title: '测试笔记二',
         date: '2026年03月18日 12:39',
         views: 10,
         likes: 0,
@@ -106,7 +106,7 @@ describe('xiaohongshu creator-notes', () => {
 4
 5
 权限设置`,
-        html: '"noteId":"69ba940500000000200384db"',
+        html: '"noteId":"aaaaaaaaaaaaaaaaaaaaaaaa"',
       },
     ]);
 
@@ -116,14 +116,14 @@ describe('xiaohongshu creator-notes', () => {
     expect(result).toEqual([
       {
         rank: 1,
-        id: '69ba940500000000200384db',
+        id: 'aaaaaaaaaaaaaaaaaaaaaaaa',
         title: '示例笔记',
         date: '2026年03月19日 12:00',
         views: 10,
         likes: 3,
         collects: 4,
         comments: 2,
-        url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+        url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=aaaaaaaaaaaaaaaaaaaaaaaa',
       },
     ]);
   });
@@ -136,8 +136,8 @@ describe('xiaohongshu creator-notes', () => {
       undefined,
       [
         {
-          id: '693155fc000000000d03b42c',
-          title: '神雕侠侣战力金字塔',
+          id: 'bbbbbbbbbbbbbbbbbbbbbbbb',
+          title: '测试笔记一',
           date: '2025年12月04日 19:45',
           metrics: [148284, 319, 2280, 466, 33],
         },
@@ -149,14 +149,14 @@ describe('xiaohongshu creator-notes', () => {
     expect(result).toEqual([
       {
         rank: 1,
-        id: '693155fc000000000d03b42c',
-        title: '神雕侠侣战力金字塔',
+        id: 'bbbbbbbbbbbbbbbbbbbbbbbb',
+        title: '测试笔记一',
         date: '2025年12月04日 19:45',
         views: 148284,
         likes: 2280,
         collects: 466,
         comments: 319,
-        url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=693155fc000000000d03b42c',
+        url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=bbbbbbbbbbbbbbbbbbbbbbbb',
       },
     ]);
   });
@@ -169,8 +169,8 @@ describe('xiaohongshu creator-notes', () => {
       data: {
         note_infos: [
           {
-            id: '69ba940500000000200384db',
-            title: '一张图讲清 诡秘之主·耕种者途径',
+            id: 'cccccccccccccccccccccccc',
+            title: '示例内容复盘',
             post_time: new Date('2026-03-18T20:01:00+08:00').getTime(),
             read_count: 521,
             like_count: 18,
@@ -187,28 +187,28 @@ describe('xiaohongshu creator-notes', () => {
     expect(result).toEqual([
       {
         rank: 1,
-        id: '69ba940500000000200384db',
-        title: '一张图讲清 诡秘之主·耕种者途径',
+        id: 'cccccccccccccccccccccccc',
+        title: '示例内容复盘',
         date: '2026年03月18日 20:01',
         views: 521,
         likes: 18,
         collects: 10,
         comments: 7,
-        url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+        url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=cccccccccccccccccccccccc',
       },
     ]);
   });
 
   it('extracts note ids from creator note-manager html', () => {
     const html = `
-      <div>&quot;noteId&quot;:&quot;69ba940500000000200384db&quot;</div>
-      <div>&quot;noteId&quot;:&quot;69ba2c98000000001a026e0f&quot;</div>
-      <div>&quot;noteId&quot;:&quot;69ba940500000000200384db&quot;</div>
+      <div>&quot;noteId&quot;:&quot;aaaaaaaaaaaaaaaaaaaaaaaa&quot;</div>
+      <div>&quot;noteId&quot;:&quot;dddddddddddddddddddddddd&quot;</div>
+      <div>&quot;noteId&quot;:&quot;aaaaaaaaaaaaaaaaaaaaaaaa&quot;</div>
     `;
 
     expect(parseCreatorNoteIdsFromHtml(html)).toEqual([
-      '69ba940500000000200384db',
-      '69ba2c98000000001a026e0f',
+      'aaaaaaaaaaaaaaaaaaaaaaaa',
+      'dddddddddddddddddddddddd',
     ]);
   });
 });

package/src/commanderAdapter.test.ts

@@ -153,3 +153,50 @@ describe('commanderAdapter command aliases', () => {
     expect(mockExecuteCommand).toHaveBeenCalledWith(cmd, {}, false);
   });
 });
+
+describe('commanderAdapter default formats', () => {
+  const cmd: CliCommand = {
+    site: 'gemini',
+    name: 'ask',
+    description: 'Ask Gemini',
+    browser: false,
+    args: [],
+    columns: ['response'],
+    defaultFormat: 'plain',
+    func: vi.fn(),
+  };
+
+  beforeEach(() => {
+    mockExecuteCommand.mockReset();
+    mockExecuteCommand.mockResolvedValue([{ response: 'hello' }]);
+    mockRenderOutput.mockReset();
+    delete process.env.OPENCLI_VERBOSE;
+    process.exitCode = undefined;
+  });
+
+  it('uses the command defaultFormat when the user keeps the default table format', async () => {
+    const program = new Command();
+    const siteCmd = program.command('gemini');
+    registerCommandToProgram(siteCmd, cmd);
+
+    await program.parseAsync(['node', 'opencli', 'gemini', 'ask']);
+
+    expect(mockRenderOutput).toHaveBeenCalledWith(
+      [{ response: 'hello' }],
+      expect.objectContaining({ fmt: 'plain' }),
+    );
+  });
+
+  it('respects an explicit user format over the command defaultFormat', async () => {
+    const program = new Command();
+    const siteCmd = program.command('gemini');
+    registerCommandToProgram(siteCmd, cmd);
+
+    await program.parseAsync(['node', 'opencli', 'gemini', 'ask', '--format', 'json']);
+
+    expect(mockRenderOutput).toHaveBeenCalledWith(
+      [{ response: 'hello' }],
+      expect.objectContaining({ fmt: 'json' }),
+    );
+  });
+});

package/src/commanderAdapter.ts

@@ -69,7 +69,7 @@ export function registerCommandToProgram(siteCmd: Command, cmd: CliCommand): voi
     }
   }
   subCmd
-    .option('-f, --format <fmt>', 'Output format: table, json, yaml, md, csv', 'table')
+    .option('-f, --format <fmt>', 'Output format: table, plain, json, yaml, md, csv', 'table')
     .option('-v, --verbose', 'Debug output', false);
 
   subCmd.addHelpText('after', formatRegistryHelpText(cmd));
@@ -95,7 +95,7 @@ export function registerCommandToProgram(siteCmd: Command, cmd: CliCommand): voi
       }
 
       const verbose = optionsRecord.verbose === true;
-      const format = typeof optionsRecord.format === 'string' ? optionsRecord.format : 'table';
+      let format = typeof optionsRecord.format === 'string' ? optionsRecord.format : 'table';
       if (verbose) process.env.OPENCLI_VERBOSE = '1';
       if (cmd.deprecated) {
         const message = typeof cmd.deprecated === 'string' ? cmd.deprecated : `${fullName(cmd)} is deprecated.`;
@@ -108,10 +108,14 @@ export function registerCommandToProgram(siteCmd: Command, cmd: CliCommand): voi
         return;
       }
 
+      const resolved = getRegistry().get(fullName(cmd)) ?? cmd;
+      if (format === 'table' && resolved.defaultFormat) {
+        format = resolved.defaultFormat;
+      }
+
       if (verbose && (!result || (Array.isArray(result) && result.length === 0))) {
         console.error(chalk.yellow('[Verbose] Warning: Command returned an empty result.'));
       }
-      const resolved = getRegistry().get(fullName(cmd)) ?? cmd;
       renderOutput(result, {
         fmt: format,
         columns: resolved.columns,

package/src/commands/daemon.test.ts

@@ -10,7 +10,7 @@ vi.mock('chalk', () => ({
 }));
 
 const mockConnect = vi.fn();
-vi.mock('../browser/mcp.js', () => ({
+vi.mock('../browser/bridge.js', () => ({
   BrowserBridge: class {
     connect = mockConnect;
   },