@jackwener/opencli 1.7.18 → 1.7.20

package/dist/src/execution.test.js

@@ -370,13 +370,11 @@ describe('executeCommand — non-browser timeout', () => {
         expect(closeWindow).toHaveBeenCalledTimes(1);
         vi.restoreAllMocks();
     });
-    it('skips closeWindow when OPENCLI_KEEP_TAB=true (success path)', async () => {
+    it('skips closeWindow when --keep-tab=true (success path)', async () => {
         const closeWindow = vi.fn().mockResolvedValue(undefined);
         const mockPage = { closeWindow };
         vi.spyOn(capRouting, 'shouldUseBrowserSession').mockReturnValue(true);
         vi.spyOn(runtime, 'browserSession').mockImplementation(async (_Factory, fn) => fn(mockPage));
-        const prev = process.env.OPENCLI_KEEP_TAB;
-        process.env.OPENCLI_KEEP_TAB = 'true';
         try {
             const cmd = cli({
                 site: 'test-execution',
@@ -386,24 +384,18 @@ describe('executeCommand — non-browser timeout', () => {
                 strategy: Strategy.PUBLIC,
                 func: async () => [{ ok: true }],
             });
-            await executeCommand(cmd, {});
+            await executeCommand(cmd, {}, false, { keepTab: 'true' });
             expect(closeWindow).not.toHaveBeenCalled();
         }
         finally {
-            if (prev === undefined)
-                delete process.env.OPENCLI_KEEP_TAB;
-            else
-                process.env.OPENCLI_KEEP_TAB = prev;
             vi.restoreAllMocks();
         }
     });
-    it('skips closeWindow when OPENCLI_KEEP_TAB=true (failure path)', async () => {
+    it('skips closeWindow when --keep-tab=true (failure path)', async () => {
         const closeWindow = vi.fn().mockResolvedValue(undefined);
         const mockPage = { closeWindow };
         vi.spyOn(capRouting, 'shouldUseBrowserSession').mockReturnValue(true);
         vi.spyOn(runtime, 'browserSession').mockImplementation(async (_Factory, fn) => fn(mockPage));
-        const prev = process.env.OPENCLI_KEEP_TAB;
-        process.env.OPENCLI_KEEP_TAB = 'true';
         try {
             const cmd = cli({
                 site: 'test-execution',
@@ -413,14 +405,10 @@ describe('executeCommand — non-browser timeout', () => {
                 strategy: Strategy.PUBLIC,
                 func: async () => { throw new Error('adapter failure'); },
             });
-            await expect(executeCommand(cmd, {})).rejects.toThrow('adapter failure');
+            await expect(executeCommand(cmd, {}, false, { keepTab: 'true' })).rejects.toThrow('adapter failure');
             expect(closeWindow).not.toHaveBeenCalled();
         }
         finally {
-            if (prev === undefined)
-                delete process.env.OPENCLI_KEEP_TAB;
-            else
-                process.env.OPENCLI_KEEP_TAB = prev;
             vi.restoreAllMocks();
         }
     });

package/dist/src/external-clis.yaml

@@ -14,6 +14,12 @@
   install:
     mac: "brew install --cask obsidian"
 
+- name: ntn
+  binary: ntn
+  description: "Notion CLI — official Notion API CLI for pages, databases, blocks, search, comments"
+  homepage: "https://ntn.dev"
+  tags: [notion, notes, knowledge, productivity]
+
 - name: docker
   binary: docker
   description: "Docker command-line interface"
@@ -55,24 +61,27 @@
   install:
     default: "npm install -g vercel"
 
-- name: tg-cli
+- name: tg
   binary: tg
+  package: tg-cli
   description: "Telegram CLI — local-first sync, search, export via MTProto for AI agents"
   homepage: "https://github.com/jackwener/tg-cli"
   tags: [telegram, messaging, search, export, ai-agent]
   install:
     default: "uv tool install kabi-tg-cli"
 
-- name: discord-cli
+- name: discord
   binary: discord
+  package: discord-cli
   description: "Discord CLI — local-first sync, search, export via SQLite for AI agents"
   homepage: "https://github.com/jackwener/discord-cli"
   tags: [discord, messaging, search, export, ai-agent]
   install:
     default: "uv tool install kabi-discord-cli"
 
-- name: wx-cli
+- name: wx
   binary: wx
+  package: wx-cli
   description: "WeChat local data CLI — sessions, messages, search, contacts, export for AI agents"
   homepage: "https://github.com/jackwener/wx-cli"
   tags: [wechat, messaging, search, export, ai-agent]

package/dist/src/external.d.ts

@@ -5,8 +5,11 @@ export interface ExternalCliInstall {
     default?: string;
 }
 export interface ExternalCliConfig {
+    /** User-facing OpenCLI subcommand and, by default, the executable name. */
     name: string;
     binary: string;
+    /** Distribution/project name when it differs from the executable name. */
+    package?: string;
     description?: string;
     homepage?: string;
     tags?: string[];
@@ -15,6 +18,7 @@ export interface ExternalCliConfig {
 export declare function loadExternalClis(): ExternalCliConfig[];
 export declare function isBinaryInstalled(binary: string): boolean;
 export declare function getInstallCmd(installConfig?: ExternalCliInstall): string | null;
+export declare function formatExternalCliLabel(cli: ExternalCliConfig): string;
 /**
  * Safely parses a command string into a binary and argument list.
  * Rejects commands containing shell operators (&&, ||, |, ;, >, <, `) that

package/dist/src/external.js

@@ -70,6 +70,9 @@ export function getInstallCmd(installConfig) {
         return installConfig.default;
     return null;
 }
+export function formatExternalCliLabel(cli) {
+    return cli.package && cli.package !== cli.name ? `${cli.name}(${cli.package})` : cli.name;
+}
 /**
  * Safely parses a command string into a binary and argument list.
  * Rejects commands containing shell operators (&&, ||, |, ;, >, <, `) that

package/dist/src/external.test.js

@@ -1,4 +1,8 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import yaml from 'js-yaml';
 const { mockExecFileSync, mockPlatform } = vi.hoisted(() => ({
     mockExecFileSync: vi.fn(),
     mockPlatform: vi.fn(() => 'darwin'),
@@ -14,7 +18,8 @@ vi.mock('node:os', async () => {
         platform: mockPlatform,
     };
 });
-import { installExternalCli, parseCommand } from './external.js';
+import { formatExternalCliLabel, installExternalCli, parseCommand } from './external.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 describe('parseCommand', () => {
     it('splits binaries and quoted arguments without invoking a shell', () => {
         expect(parseCommand('npm install -g "@scope/tool name"')).toEqual({
@@ -29,6 +34,24 @@ describe('parseCommand', () => {
         expect(() => parseCommand('brew install $(whoami)')).toThrow('Install command contains unsafe shell operators');
         expect(() => parseCommand('brew install gh\nrm -rf /')).toThrow('Install command contains unsafe shell operators');
     });
+    it('keeps built-in install commands compatible with the shell-free parser', () => {
+        const raw = fs.readFileSync(path.join(__dirname, 'external-clis.yaml'), 'utf8');
+        const entries = (yaml.load(raw) || []);
+        for (const entry of entries) {
+            for (const command of Object.values(entry.install ?? {})) {
+                if (command)
+                    expect(() => parseCommand(command)).not.toThrow();
+            }
+        }
+    });
+});
+describe('formatExternalCliLabel', () => {
+    it('shows the package name when the executable name differs', () => {
+        expect(formatExternalCliLabel({ name: 'wx', binary: 'wx', package: 'wx-cli' })).toBe('wx(wx-cli)');
+    });
+    it('keeps the label compact when package and name match', () => {
+        expect(formatExternalCliLabel({ name: 'docker', binary: 'docker', package: 'docker' })).toBe('docker');
+    });
 });
 describe('installExternalCli', () => {
     const cli = {

package/dist/src/help.d.ts

@@ -40,13 +40,28 @@ export type AdapterKind = 'site' | 'app';
 export declare function classifyAdapter(domain: string | undefined): AdapterKind;
 export interface RootAdapterGroups {
     /** Externally-registered CLIs (docker, gh, vercel, ...) — passthrough binaries */
-    external: readonly string[];
+    external: readonly RootExternalCli[];
     /** Desktop-app adapters (chatgpt-app, chatwise, codex, ...) */
     apps: readonly string[];
     /** Web-site adapters (bilibili, dianping, ...) */
     sites: readonly string[];
 }
+export interface RootExternalCli {
+    name: string;
+    label: string;
+}
 export declare function formatRootAdapterHelpText(groups: RootAdapterGroups): string;
+/**
+ * Extracts a positional placeholder that should appear immediately after this
+ * command's name in user-facing path strings. Reads the leading positional
+ * (e.g. `<session>`) from a `.usage()` override; commands without a positional
+ * override return `null` so the path stays as-is.
+ *
+ * Example: `browser` declares `.usage('<session> <command> [options]')`,
+ * so `commanderPath(browserClickCmd)` becomes
+ * `['opencli', 'browser', '<session>', 'click']`.
+ */
+export declare function leadingPositionalFromUsage(command: Command): string | null;
 export declare function commanderNamespaceHelpData(namespaceRoot: Command, opts?: {
     globalCommand?: Command;
     description?: string;

package/dist/src/help.js

@@ -116,7 +116,7 @@ export function formatRootAdapterHelpText(groups) {
     if (total === 0)
         return '';
     const lines = [''];
-    lines.push(...formatGroupSection('External CLIs', groups.external));
+    lines.push(...formatGroupSection('External CLIs', groups.external.map(cli => cli.label)));
     lines.push(...formatGroupSection('App adapters', groups.apps));
     lines.push(...formatGroupSection('Site adapters', groups.sites));
     lines.push("Run 'opencli list' for full command details, or 'opencli <site> --help' to inspect one site.");
@@ -175,13 +175,42 @@ function compactCommanderOptions(options) {
         .map(compactCommanderOption)
         .filter((option) => option !== null);
 }
+/**
+ * Extracts a positional placeholder that should appear immediately after this
+ * command's name in user-facing path strings. Reads the leading positional
+ * (e.g. `<session>`) from a `.usage()` override; commands without a positional
+ * override return `null` so the path stays as-is.
+ *
+ * Example: `browser` declares `.usage('<session> <command> [options]')`,
+ * so `commanderPath(browserClickCmd)` becomes
+ * `['opencli', 'browser', '<session>', 'click']`.
+ */
+export function leadingPositionalFromUsage(command) {
+    const usage = command._usage;
+    if (!usage)
+        return null;
+    const match = usage.match(/^\s*(<[^>]+>)/);
+    return match ? match[1] : null;
+}
 function commanderPath(command) {
     const parts = [];
     let current = command;
     while (current) {
         const name = current.name();
-        if (name)
+        if (name) {
             parts.push(name);
+            // If this command declares a leading-positional usage override AND we
+            // have already collected a child name below it, the positional must
+            // appear between this command and the child (i.e. before the names
+            // already collected). parts is in reverse order, so push to the end.
+            const positional = leadingPositionalFromUsage(current);
+            if (positional && parts.length > 1) {
+                // We collected child names first (reverse order). Move them up by one
+                // and put the positional at index `parts.length - 2` so reverse()
+                // places it between this command and the first child name.
+                parts.splice(parts.length - 1, 0, positional);
+            }
+        }
         current = current.parent;
     }
     return parts.reverse();
@@ -189,7 +218,10 @@ function commanderPath(command) {
 function commandPathFromRoot(namespaceRoot, command) {
     const rootPath = commanderPath(namespaceRoot);
     const commandPath = commanderPath(command);
-    return commandPath.slice(rootPath.length);
+    // Strip placeholder positional segments (e.g. `<session>`) from the relative
+    // name so agents can still address subcommands by their leaf name. Display
+    // paths in `command` / `usage` still include the placeholders.
+    return commandPath.slice(rootPath.length).filter(part => !/^<.+>$/.test(part));
 }
 function collectLeafCommands(command) {
     if (command.commands.length === 0)
@@ -232,10 +264,19 @@ export function commanderNamespaceHelpData(namespaceRoot, opts = {}) {
     const leaves = collectLeafCommands(namespaceRoot)
         .filter(command => command !== namespaceRoot)
         .sort((a, b) => commandPathFromRoot(namespaceRoot, a).join(' ').localeCompare(commandPathFromRoot(namespaceRoot, b).join(' ')));
+    // Respect commander's `.usage()` override (e.g. `<session> <command> [options]`
+    // on `browser`); fall back to the generic `<command> [args] [options]` form.
+    // Read the private `_usage` field directly because `.usage()` returns the
+    // auto-generated form if no override was set.
+    const commandPath = commanderPath(namespaceRoot).join(' ');
+    const usageOverride = namespaceRoot._usage;
+    const usage = usageOverride
+        ? `${commandPath} ${usageOverride}`
+        : `${commandPath} <command> [args] [options]`;
     return {
         namespace: namespaceRoot.name(),
-        command: commanderPath(namespaceRoot).join(' '),
-        usage: `${commanderPath(namespaceRoot).join(' ')} <command> [args] [options]`,
+        command: commandPath,
+        usage,
         description: opts.description ?? namespaceRoot.description(),
         command_count: leaves.length,
         commands: leaves.map(command => compactCommanderCommand(namespaceRoot, command, opts)),
@@ -243,7 +284,7 @@ export function commanderNamespaceHelpData(namespaceRoot, opts = {}) {
         ...(opts.globalCommand ? { global_options: compactCommanderOptions(opts.globalCommand.options) } : {}),
         structured_help: {
             formats: ['yaml', 'json'],
-            usage: `${commanderPath(namespaceRoot).join(' ')} --help -f yaml`,
+            usage: `${commandPath} --help -f yaml`,
         },
     };
 }
@@ -335,7 +376,7 @@ function compactCommand(cmd) {
     };
 }
 export function rootHelpData(program, groups) {
-    const adapterNames = new Set([...groups.external, ...groups.apps, ...groups.sites]);
+    const adapterNames = new Set([...groups.external.map(cli => cli.name), ...groups.apps, ...groups.sites]);
     const commands = program.commands
         .filter(command => !adapterNames.has(command.name()))
         .map(command => ({
@@ -349,7 +390,8 @@ export function rootHelpData(program, groups) {
         commands,
         external_clis: {
             count: groups.external.length,
-            clis: [...groups.external].sort(sortLocale),
+            clis: groups.external.map(cli => cli.name).sort(sortLocale),
+            display: groups.external.map(cli => cli.label).sort(sortLocale),
         },
         app_adapters: {
             count: groups.apps.length,

package/dist/src/help.test.js

@@ -20,13 +20,17 @@ describe('classifyAdapter', () => {
 describe('formatRootAdapterHelpText', () => {
     it('renders all three sections in External / App / Site order when populated', () => {
         const text = formatRootAdapterHelpText({
-            external: ['gh', 'docker'],
+            external: [
+                { name: 'gh', label: 'gh' },
+                { name: 'wx', label: 'wx(wx-cli)' },
+            ],
             apps: ['chatwise', 'codex'],
             sites: ['bilibili'],
         });
         expect(text).toContain('External CLIs (2):');
         expect(text).toContain('App adapters (2):');
         expect(text).toContain('Site adapters (1):');
+        expect(text).toContain('wx(wx-cli)');
         expect(text.indexOf('External CLIs')).toBeLessThan(text.indexOf('App adapters'));
         expect(text.indexOf('App adapters')).toBeLessThan(text.indexOf('Site adapters'));
     });

package/dist/src/logger.js

@@ -4,35 +4,34 @@
  * All framework output (warnings, debug info, errors) should go through
  * this module so that verbosity levels are respected consistently.
  */
-import { styleText } from 'node:util';
 function isVerbose() {
     return !!process.env.OPENCLI_VERBOSE;
 }
 export const log = {
     /** Informational message (always shown) */
     info(msg) {
-        process.stderr.write(`${styleText('blue', 'ℹ')}  ${msg}\n`);
+        process.stderr.write(`ℹ  ${msg}\n`);
     },
     /** Lightweight status line for adapter progress updates */
     status(msg) {
-        process.stderr.write(`${styleText('dim', msg)}\n`);
+        process.stderr.write(`${msg}\n`);
     },
     /** Positive completion/status line without the heavier info prefix */
     success(msg) {
-        process.stderr.write(`${styleText('green', msg)}\n`);
+        process.stderr.write(`${msg}\n`);
     },
     /** Warning (always shown) */
     warn(msg) {
-        process.stderr.write(`${styleText('yellow', '⚠')}  ${msg}\n`);
+        process.stderr.write(`⚠  ${msg}\n`);
     },
     /** Error (always shown) */
     error(msg) {
-        process.stderr.write(`${styleText('red', '✖')}  ${msg}\n`);
+        process.stderr.write(`✖  ${msg}\n`);
     },
     /** Verbose output (shown when -v flag or OPENCLI_VERBOSE is set) */
     verbose(msg) {
         if (isVerbose()) {
-            process.stderr.write(`${styleText('dim', '[verbose]')} ${msg}\n`);
+            process.stderr.write(`[verbose] ${msg}\n`);
         }
     },
     /** Alias for verbose output. */
@@ -41,10 +40,10 @@ export const log = {
     },
     /** Step-style debug (for pipeline steps, etc.) */
     step(stepNum, total, op, preview = '') {
-        process.stderr.write(`  ${styleText('dim', `[${stepNum}/${total}]`)} ${styleText(['bold', 'cyan'], op)}${preview}\n`);
+        process.stderr.write(`  [${stepNum}/${total}] ${op}${preview}\n`);
     },
     /** Step result summary */
     stepResult(summary) {
-        process.stderr.write(`       ${styleText('dim', `→ ${summary}`)}\n`);
+        process.stderr.write(`       → ${summary}\n`);
     },
 };

package/dist/src/main.js

@@ -139,5 +139,21 @@ if (getCompIdx !== -1) {
     process.stdout.write(candidates.join('\n') + '\n');
     process.exit(EXIT_CODES.SUCCESS);
 }
+// Rewrite `opencli browser <session> <subcommand> ...` so commander (which
+// can't combine a parent positional with subcommand dispatch) sees the internal
+// `--session <name>` flag form. Also refuses the retired `opencli browser
+// --session foo ...` user form with a friendly usage error.
+const { rewriteBrowserArgv, BrowserSessionArgvError } = await import('./cli-argv-preprocess.js');
+try {
+    const rewritten = rewriteBrowserArgv(process.argv.slice(2));
+    process.argv.splice(2, process.argv.length - 2, ...rewritten);
+}
+catch (err) {
+    if (err instanceof BrowserSessionArgvError) {
+        process.stderr.write(`error: ${err.message}\n`);
+        process.exit(EXIT_CODES.GENERIC_ERROR);
+    }
+    throw err;
+}
 await emitHook('onStartup', { command: '__startup__', args: {} });
 runCli(BUILTIN_CLIS, USER_CLIS);

package/dist/src/output.js

@@ -1,7 +1,6 @@
 /**
  * Output formatting: table, JSON, Markdown, CSV, YAML.
  */
-import { styleText } from 'node:util';
 import Table from 'cli-table3';
 import yaml from 'js-yaml';
 function normalizeRows(data) {
@@ -51,13 +50,13 @@ export function render(data, opts = {}) {
 function renderTable(data, opts) {
     const rows = normalizeRows(data);
     if (!rows.length) {
-        console.log(styleText('dim', '(no data)'));
+        console.log('(no data)');
         return;
     }
     const columns = resolveColumns(rows, opts);
     const header = columns.map(c => capitalize(c));
     const table = new Table({
-        head: header.map(h => styleText('bold', h)),
+        head: header.map(h => h),
         style: { head: [], border: [] },
         wordWrap: true,
         wrapOnWordBoundary: true,
@@ -70,7 +69,7 @@ function renderTable(data, opts) {
     }
     console.log();
     if (opts.title)
-        console.log(styleText('dim', `  ${opts.title}`));
+        console.log(`  ${opts.title}`);
     console.log(table.toString());
     const footer = [];
     footer.push(`${rows.length} items`);
@@ -80,7 +79,7 @@ function renderTable(data, opts) {
         footer.push(opts.source);
     if (opts.footerExtra)
         footer.push(opts.footerExtra);
-    console.log(styleText('dim', footer.join(' · ')));
+    console.log(footer.join(' · '));
 }
 function renderJson(data) {
     console.log(JSON.stringify(data, null, 2));

package/dist/src/runtime-detect.d.ts

@@ -6,7 +6,7 @@
  * (e.g. logging, diagnostics) without littering runtime sniffing everywhere.
  */
 export type Runtime = 'bun' | 'node';
-export declare const MIN_SUPPORTED_NODE_MAJOR = 21;
+export declare const MIN_SUPPORTED_NODE_MAJOR = 20;
 /**
  * Detect the current JavaScript runtime.
  */

package/dist/src/runtime-detect.js

@@ -5,7 +5,7 @@
  * This module centralises the check so other code can adapt behaviour
  * (e.g. logging, diagnostics) without littering runtime sniffing everywhere.
  */
-export const MIN_SUPPORTED_NODE_MAJOR = 21;
+export const MIN_SUPPORTED_NODE_MAJOR = 20;
 /**
  * Detect the current JavaScript runtime.
  */

package/dist/src/runtime-detect.test.js

@@ -30,8 +30,9 @@ describe('runtime-detect', () => {
         expect(parseNodeMajor('bun-1.2.0')).toBeNull();
     });
     it('checks the current minimum supported Node major version', () => {
-        expect(MIN_SUPPORTED_NODE_MAJOR).toBe(21);
-        expect(isSupportedNodeVersion('v20.18.0')).toBe(false);
+        expect(MIN_SUPPORTED_NODE_MAJOR).toBe(20);
+        expect(isSupportedNodeVersion('v19.9.0')).toBe(false);
+        expect(isSupportedNodeVersion('v20.0.0')).toBe(true);
         expect(isSupportedNodeVersion('v21.0.0')).toBe(true);
         expect(isSupportedNodeVersion('v25.0.0')).toBe(true);
     });

package/dist/src/tui.d.ts

@@ -4,7 +4,6 @@ export interface CheckboxItem {
     checked: boolean;
     /** Optional status to display after the label */
     status?: string;
-    statusColor?: 'green' | 'yellow' | 'red' | 'dim';
 }
 /**
  * Interactive multi-select checkbox prompt.

package/dist/src/tui.js

@@ -3,7 +3,6 @@
  *
  * Uses raw stdin mode + ANSI escape codes for interactive prompts.
  */
-import { styleText } from 'node:util';
 import { EXIT_CODES } from './errors.js';
 /**
  * Interactive multi-select checkbox prompt.
@@ -25,32 +24,20 @@ export async function checkboxPrompt(items, opts = {}) {
     }
     let cursor = 0;
     const state = items.map(i => ({ ...i }));
-    function colorStatus(status, color) {
-        if (!status)
-            return '';
-        switch (color) {
-            case 'green': return styleText('green', status);
-            case 'yellow': return styleText('yellow', status);
-            case 'red': return styleText('red', status);
-            case 'dim': return styleText('dim', status);
-            default: return styleText('dim', status);
-        }
-    }
     function render() {
         // Move cursor to start and clear
         let out = '';
         if (opts.title) {
-            out += `\n${styleText('bold', opts.title)}\n\n`;
+            out += `\n${opts.title}\n\n`;
         }
         for (let i = 0; i < state.length; i++) {
             const item = state[i];
-            const pointer = i === cursor ? styleText('cyan', '❯') : ' ';
-            const checkbox = item.checked ? styleText('green', '◉') : styleText('dim', '○');
-            const label = i === cursor ? styleText('bold', item.label) : item.label;
-            const status = colorStatus(item.status, item.statusColor);
-            out += `  ${pointer} ${checkbox} ${label}${status ? `  ${status}` : ''}\n`;
+            const pointer = i === cursor ? '❯' : ' ';
+            const checkbox = item.checked ? '◉' : '○';
+            const status = item.status ?? '';
+            out += `  ${pointer} ${checkbox} ${item.label}${status ? `  ${status}` : ''}\n`;
         }
-        out += `\n  ${styleText('dim', '↑↓ navigate  ·  Space toggle  ·  a all  ·  Enter confirm  ·  q cancel')}\n`;
+        out += `\n  ↑↓ navigate  ·  Space toggle  ·  a all  ·  Enter confirm  ·  q cancel\n`;
         return out;
     }
     return new Promise((resolve) => {
@@ -117,14 +104,14 @@ export async function checkboxPrompt(items, opts = {}) {
                 cleanup();
                 const selected = state.filter(i => i.checked).map(i => i.value);
                 // Show summary
-                stdout.write(`  ${styleText('green', '✓')} ${styleText('bold', `${selected.length} file(s) selected`)}\n\n`);
+                stdout.write(`  ✓ ${selected.length} file(s) selected\n\n`);
                 resolve(selected);
                 return;
             }
             // q / Esc — cancel
             if (key === 'q' || key === '\x1b') {
                 cleanup();
-                stdout.write(`  ${styleText('yellow', '✗')} ${styleText('dim', 'Cancelled')}\n\n`);
+                stdout.write(`  ✗ Cancelled\n\n`);
                 resolve([]);
                 return;
             }
@@ -149,7 +136,7 @@ export async function confirmPrompt(message, defaultYes = true) {
     if (!stdin.isTTY)
         return defaultYes;
     const hint = defaultYes ? '[Y/n]' : '[y/N]';
-    stdout.write(`  ${message} ${styleText('dim', hint)} `);
+    stdout.write(`  ${message} ${hint} `);
     return new Promise((resolve) => {
         const wasRaw = stdin.isRaw;
         stdin.setRawMode(true);

package/dist/src/types.d.ts

@@ -60,12 +60,14 @@ export interface FetchJsonOptions {
     body?: unknown;
     timeoutMs?: number;
 }
+export type BrowserEvaluateFunction<Args extends unknown[] = unknown[], Result = unknown> = (...args: Args) => Result | Promise<Result>;
 export interface IPage {
     goto(url: string, options?: {
         waitUntil?: 'load' | 'none';
         settleMs?: number;
     }): Promise<void>;
-    evaluate(js: string): Promise<any>;
+    evaluate<T = any>(js: string): Promise<T>;
+    evaluate<Args extends unknown[], T>(fn: BrowserEvaluateFunction<Args, T>, ...args: Args): Promise<Awaited<T>>;
     /** Safely evaluate JS with pre-serialized arguments — prevents injection. */
     evaluateWithArgs?(js: string, args: Record<string, unknown>): Promise<any>;
     /**

package/dist/src/update-check.js

@@ -16,7 +16,6 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
-import { styleText } from 'node:util';
 import { PKG_VERSION } from './version.js';
 const CACHE_DIR = path.join(os.homedir(), '.opencli');
 const CACHE_FILE = path.join(CACHE_DIR, 'update-check.json');
@@ -70,8 +69,8 @@ function buildUpdateNotices({ cliVersion, cache, now }) {
     const lines = {};
     if (cache.latestVersion && isNewer(cache.latestVersion, cliVersion)) {
         lines.cli =
-            styleText('yellow', `\n  Update available: v${cliVersion} → v${cache.latestVersion}\n`) +
-                styleText('dim', `  Run: npm install -g @jackwener/opencli\n`);
+            `\n  Update available: v${cliVersion} → v${cache.latestVersion}\n` +
+                `  Run: npm install -g @jackwener/opencli\n`;
     }
     const { currentExtensionVersion, latestExtensionVersion, extensionLastSeenAt } = cache;
     if (currentExtensionVersion &&
@@ -80,8 +79,8 @@ function buildUpdateNotices({ cliVersion, cache, now }) {
         now - extensionLastSeenAt < EXTENSION_STALE_MS &&
         isNewer(latestExtensionVersion, currentExtensionVersion)) {
         lines.extension =
-            styleText('yellow', `\n  Extension update available: v${currentExtensionVersion} → v${latestExtensionVersion}\n`) +
-                styleText('dim', `  Download: https://github.com/jackwener/opencli/releases\n`);
+            `\n  Extension update available: v${currentExtensionVersion} → v${latestExtensionVersion}\n` +
+                `  Download: https://github.com/jackwener/opencli/releases\n`;
     }
     return lines;
 }