@jackwener/opencli 1.0.6 → 1.1.0

package/dist/clis/xiaohongshu/creator-notes-summary.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'vitest';
+import { summarizeCreatorNote } from './creator-notes-summary.js';
+import './creator-notes-summary.js';
+describe('xiaohongshu creator-notes-summary', () => {
+    it('summarizes note list row and detail rows into one compact row', () => {
+        const note = {
+            id: '69ba940500000000200384db',
+            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',
+        };
+        const rows = [
+            { section: '笔记信息', metric: 'published_at', value: '2026-03-18 20:01', extra: '' },
+            { section: '基础数据', metric: '观看数', value: '549', extra: '' },
+            { section: '互动数据', metric: '点赞数', value: '19', extra: '' },
+            { section: '互动数据', metric: '收藏数', value: '10', extra: '' },
+            { section: '互动数据', metric: '评论数', value: '7', extra: '' },
+            { section: '互动数据', metric: '分享数', value: '6', extra: '' },
+            { section: '基础数据', metric: '平均观看时长', value: '51.5秒', extra: '' },
+            { section: '基础数据', metric: '涨粉数', value: '3', extra: '' },
+            { section: '观看来源', metric: '首页推荐', value: '89.9%', extra: '' },
+            { section: '观看来源', metric: '搜索', value: '0.3%', extra: '' },
+            { section: '观众画像', metric: '兴趣/二次元', value: '13%', extra: '' },
+            { section: '观众画像', metric: '兴趣/游戏', value: '11%', extra: '' },
+        ];
+        expect(summarizeCreatorNote(note, rows, 1)).toEqual({
+            rank: 1,
+            id: '69ba940500000000200384db',
+            title: '一张图讲清 诡秘之主·耕种者途径',
+            published_at: '2026-03-18 20:01',
+            views: '549',
+            likes: '19',
+            collects: '10',
+            comments: '7',
+            shares: '6',
+            avg_view_time: '51.5秒',
+            rise_fans: '3',
+            top_source: '首页推荐',
+            top_source_pct: '89.9%',
+            top_interest: '二次元',
+            top_interest_pct: '13%',
+            url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+        });
+    });
+});

package/dist/clis/xiaohongshu/creator-notes.d.ts

@@ -1,11 +1,24 @@
 /**
  * Xiaohongshu Creator Note List — per-note metrics from the creator backend.
  *
- * Navigates to the note manager page and extracts per-note data from
- * the rendered DOM. This approach bypasses the v2 API signature requirement.
- *
- * Returns: note title, publish date, views, likes, collects, comments.
+ * In CDP mode we capture the real creator analytics API response so the list
+ * includes stable note ids and detail-page URLs. If that capture is unavailable,
+ * we fall back to the older interceptor and DOM parsing paths.
  *
  * Requires: logged into creator.xiaohongshu.com in Chrome.
  */
-export {};
+import type { IPage } from '../../types.js';
+type CreatorNoteRow = {
+    id: string;
+    title: string;
+    date: string;
+    views: number;
+    likes: number;
+    collects: number;
+    comments: number;
+    url: string;
+};
+export type { CreatorNoteRow };
+export declare function parseCreatorNotesText(bodyText: string): CreatorNoteRow[];
+export declare function parseCreatorNoteIdsFromHtml(bodyHtml: string): string[];
+export declare function fetchCreatorNotes(page: IPage, limit: number): Promise<CreatorNoteRow[]>;

package/dist/clis/xiaohongshu/creator-notes.js

@@ -1,14 +1,168 @@
 /**
  * Xiaohongshu Creator Note List — per-note metrics from the creator backend.
  *
- * Navigates to the note manager page and extracts per-note data from
- * the rendered DOM. This approach bypasses the v2 API signature requirement.
- *
- * Returns: note title, publish date, views, likes, collects, comments.
+ * In CDP mode we capture the real creator analytics API response so the list
+ * includes stable note ids and detail-page URLs. If that capture is unavailable,
+ * we fall back to the older interceptor and DOM parsing paths.
  *
  * Requires: logged into creator.xiaohongshu.com in Chrome.
  */
 import { cli, Strategy } from '../../registry.js';
+const DATE_LINE_RE = /^发布于 (\d{4}年\d{2}月\d{2}日 \d{2}:\d{2})$/;
+const METRIC_LINE_RE = /^\d+$/;
+const VISIBILITY_LINE_RE = /可见$/;
+const NOTE_ANALYZE_API_PATH = '/api/galaxy/creator/datacenter/note/analyze/list';
+const NOTE_DETAIL_PAGE_URL = 'https://creator.xiaohongshu.com/statistics/note-detail';
+const NOTE_ID_HTML_RE = /"noteId":"([0-9a-f]{24})"/g;
+function buildNoteDetailUrl(noteId) {
+    return noteId ? `${NOTE_DETAIL_PAGE_URL}?noteId=${encodeURIComponent(noteId)}` : '';
+}
+function formatPostTime(ts) {
+    if (!ts)
+        return '';
+    // XHS API timestamps are Beijing time (UTC+8)
+    const date = new Date(ts + 8 * 3600_000);
+    const pad = (value) => String(value).padStart(2, '0');
+    return `${date.getUTCFullYear()}年${pad(date.getUTCMonth() + 1)}月${pad(date.getUTCDate())}日 ${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}`;
+}
+export function parseCreatorNotesText(bodyText) {
+    const lines = bodyText
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const results = [];
+    const seen = new Set();
+    for (let i = 0; i < lines.length; i++) {
+        const dateMatch = lines[i].match(DATE_LINE_RE);
+        if (!dateMatch)
+            continue;
+        let titleIndex = i - 1;
+        while (titleIndex >= 0 && VISIBILITY_LINE_RE.test(lines[titleIndex]))
+            titleIndex--;
+        if (titleIndex < 0)
+            continue;
+        const title = lines[titleIndex];
+        const metrics = [];
+        let cursor = i + 1;
+        while (cursor < lines.length && METRIC_LINE_RE.test(lines[cursor]) && metrics.length < 5) {
+            metrics.push(parseInt(lines[cursor], 10));
+            cursor++;
+        }
+        if (metrics.length < 4)
+            continue;
+        const key = `${title}@@${dateMatch[1]}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        results.push({
+            id: '',
+            title,
+            date: dateMatch[1],
+            views: metrics[0] ?? 0,
+            likes: metrics[1] ?? 0,
+            collects: metrics[2] ?? 0,
+            comments: metrics[3] ?? 0,
+            url: '',
+        });
+        i = cursor - 1;
+    }
+    return results;
+}
+export function parseCreatorNoteIdsFromHtml(bodyHtml) {
+    const ids = [];
+    const seen = new Set();
+    for (const match of bodyHtml.matchAll(NOTE_ID_HTML_RE)) {
+        const id = match[1];
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        ids.push(id);
+    }
+    return ids;
+}
+function mapAnalyzeItems(items) {
+    return (items ?? []).map((item) => ({
+        id: item.id ?? '',
+        title: item.title ?? '',
+        date: formatPostTime(item.post_time),
+        views: item.read_count ?? 0,
+        likes: item.like_count ?? 0,
+        collects: item.fav_count ?? 0,
+        comments: item.comment_count ?? 0,
+        url: buildNoteDetailUrl(item.id),
+    }));
+}
+async function fetchCreatorNotesByApi(page, limit) {
+    const pageSize = Math.min(Math.max(limit, 10), 20);
+    const maxPages = Math.max(1, Math.ceil(limit / pageSize));
+    const notes = [];
+    await page.goto(`https://creator.xiaohongshu.com/statistics/data-analysis?type=0&page_size=${pageSize}&page_num=1`);
+    await page.wait(4);
+    for (let pageNum = 1; pageNum <= maxPages && notes.length < limit; pageNum++) {
+        const apiPath = `${NOTE_ANALYZE_API_PATH}?type=0&page_size=${pageSize}&page_num=${pageNum}`;
+        const fetched = await page.evaluate(`
+      async () => {
+        try {
+          const resp = await fetch(${JSON.stringify(apiPath)}, { credentials: 'include' });
+          if (!resp.ok) return { error: 'HTTP ' + resp.status };
+          return await resp.json();
+        } catch (e) {
+          return { error: e?.message ?? String(e) };
+        }
+      }
+    `);
+        let items = fetched?.data?.note_infos ?? [];
+        if (!items.length) {
+            await page.installInterceptor(NOTE_ANALYZE_API_PATH);
+            await page.evaluate(`
+        async () => {
+          try {
+            await fetch(${JSON.stringify(apiPath)}, { credentials: 'include' });
+          } catch {}
+          return true;
+        }
+      `);
+            await page.wait(1);
+            const intercepted = await page.getInterceptedRequests();
+            const data = intercepted.find((entry) => Array.isArray(entry?.data?.note_infos));
+            items = data?.data?.note_infos ?? [];
+        }
+        if (!items.length)
+            break;
+        notes.push(...mapAnalyzeItems(items));
+        if (items.length < pageSize)
+            break;
+    }
+    return notes.slice(0, limit);
+}
+export async function fetchCreatorNotes(page, limit) {
+    let notes = await fetchCreatorNotesByApi(page, limit);
+    if (notes.length === 0) {
+        await page.goto('https://creator.xiaohongshu.com/new/note-manager');
+        await page.wait(4);
+        const maxPageDowns = Math.max(0, Math.ceil(limit / 10) + 1);
+        for (let i = 0; i <= maxPageDowns; i++) {
+            const body = await page.evaluate('() => ({ text: document.body.innerText, html: document.body.innerHTML })');
+            const bodyText = typeof body?.text === 'string' ? body.text : '';
+            const bodyHtml = typeof body?.html === 'string' ? body.html : '';
+            const parsedNotes = parseCreatorNotesText(bodyText);
+            const noteIds = parseCreatorNoteIdsFromHtml(bodyHtml);
+            notes = parsedNotes.map((note, index) => {
+                const id = noteIds[index] ?? '';
+                return {
+                    ...note,
+                    id,
+                    url: buildNoteDetailUrl(id),
+                };
+            });
+            if (notes.length >= limit || i === maxPageDowns)
+                break;
+            await page.pressKey('PageDown');
+            await page.wait(1);
+        }
+    }
+    return notes.slice(0, limit);
+}
 cli({
     site: 'xiaohongshu',
     name: 'creator-notes',
@@ -22,73 +176,7 @@ cli({
     columns: ['rank', 'id', 'title', 'date', 'views', 'likes', 'collects', 'comments', 'url'],
     func: async (page, kwargs) => {
         const limit = kwargs.limit || 20;
-        // Navigate to note manager
-        await page.goto('https://creator.xiaohongshu.com/new/note-manager');
-        await page.wait(4);
-        // Scroll to load more notes if needed
-        await page.autoScroll({ times: Math.ceil(limit / 10), delayMs: 1500 });
-        // Extract note data from rendered DOM
-        const notes = await page.evaluate(`
-      (() => {
-        const results = [];
-        // Note cards in the manager page contain title, date, and metric numbers
-        // Each note card has a consistent structure with the title, date line,
-        // and a row of 4 numbers (views, likes, collects, comments)
-        const cards = document.querySelectorAll('[class*="note-item"], [class*="noteItem"], [class*="card"]');
-
-        if (cards.length === 0) {
-          // Fallback: parse from any container with note-like content
-          const allText = document.body.innerText;
-          const notePattern = /(.+?)\\s+发布于\\s+(\\d{4}年\\d{2}月\\d{2}日\\s+\\d{2}:\\d{2})\\s*(\\d+)\\s*(\\d+)\\s*(\\d+)\\s*(\\d+)/g;
-          let match;
-          while ((match = notePattern.exec(allText)) !== null) {
-            results.push({
-              title: match[1].trim(),
-              date: match[2],
-              views: parseInt(match[3]) || 0,
-              likes: parseInt(match[4]) || 0,
-              collects: parseInt(match[5]) || 0,
-              comments: parseInt(match[6]) || 0,
-            });
-          }
-          return results;
-        }
-
-        cards.forEach(card => {
-          const text = card.innerText || '';
-          const linkEl = card.querySelector('a[href*="/publish/"], a[href*="/note/"], a[href*="/explore/"]');
-          const href = linkEl?.getAttribute('href') || '';
-          const idMatch = href.match(/\/(?:publish|explore|note)\/([a-zA-Z0-9]+)/);
-          // Try to extract structured data
-          const lines = text.split('\\n').map(l => l.trim()).filter(Boolean);
-          if (lines.length < 2) return;
-
-          const title = lines[0];
-          const dateLine = lines.find(l => l.includes('发布于'));
-          const dateMatch = dateLine?.match(/发布于\\s+(\\d{4}年\\d{2}月\\d{2}日\\s+\\d{2}:\\d{2})/);
-
-          // Remove the publish timestamp before collecting note metrics.
-          // Otherwise year/month/day/hour digits are picked up as views/likes/etc.
-          const metricText = dateLine ? text.replace(dateLine, ' ') : text;
-          const nums = metricText.match(/(?:^|\\s)(\\d+)(?:\\s|$)/g)?.map(n => parseInt(n.trim())) || [];
-
-          if (title && !title.includes('全部笔记')) {
-            results.push({
-              id: idMatch ? idMatch[1] : '',
-              title: title.replace(/\\s+/g, ' ').substring(0, 80),
-              date: dateMatch ? dateMatch[1] : '',
-              views: nums[0] || 0,
-              likes: nums[1] || 0,
-              collects: nums[2] || 0,
-              comments: nums[3] || 0,
-              url: href ? new URL(href, window.location.origin).toString() : '',
-            });
-          }
-        });
-
-        return results;
-      })()
-    `);
+        const notes = await fetchCreatorNotes(page, limit);
         if (!Array.isArray(notes) || notes.length === 0) {
             throw new Error('No notes found. Are you logged into creator.xiaohongshu.com?');
         }

package/dist/clis/xiaohongshu/creator-notes.test.d.ts

@@ -0,0 +1 @@
+import './creator-notes.js';

package/dist/clis/xiaohongshu/creator-notes.test.js

@@ -0,0 +1,162 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import { parseCreatorNoteIdsFromHtml, parseCreatorNotesText } from './creator-notes.js';
+import './creator-notes.js';
+function createPageMock(evaluateResult, interceptedRequests = []) {
+    const evaluate = Array.isArray(evaluateResult)
+        ? vi.fn()
+            .mockResolvedValueOnce(evaluateResult[0])
+            .mockResolvedValue(evaluateResult[evaluateResult.length - 1])
+        : vi.fn().mockResolvedValue(evaluateResult);
+    const getInterceptedRequests = Array.isArray(interceptedRequests)
+        ? vi.fn().mockResolvedValue(interceptedRequests)
+        : vi.fn().mockResolvedValue([]);
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        evaluate,
+        snapshot: vi.fn().mockResolvedValue(undefined),
+        click: vi.fn().mockResolvedValue(undefined),
+        typeText: vi.fn().mockResolvedValue(undefined),
+        pressKey: vi.fn().mockResolvedValue(undefined),
+        wait: vi.fn().mockResolvedValue(undefined),
+        tabs: vi.fn().mockResolvedValue([]),
+        closeTab: vi.fn().mockResolvedValue(undefined),
+        newTab: vi.fn().mockResolvedValue(undefined),
+        selectTab: vi.fn().mockResolvedValue(undefined),
+        networkRequests: vi.fn().mockResolvedValue([]),
+        consoleMessages: vi.fn().mockResolvedValue([]),
+        scroll: vi.fn().mockResolvedValue(undefined),
+        autoScroll: vi.fn().mockResolvedValue(undefined),
+        installInterceptor: vi.fn().mockResolvedValue(undefined),
+        getInterceptedRequests,
+        getCookies: vi.fn().mockResolvedValue([]),
+        screenshot: vi.fn().mockResolvedValue(''),
+    };
+}
+describe('xiaohongshu creator-notes', () => {
+    it('parses creator note text blocks into rows', () => {
+        const bodyText = `笔记管理
+全部笔记(366)
+已发布
+神雕侠侣战力金字塔
+发布于 2025年12月04日 19:45
+148208
+324
+2279
+465
+32
+权限设置
+取消置顶
+编辑
+删除
+仅自己可见
+终于等到了！！！
+发布于 2026年03月18日 12:39
+10
+0
+0
+0
+0
+权限设置`;
+        expect(parseCreatorNotesText(bodyText)).toEqual([
+            {
+                id: '',
+                title: '神雕侠侣战力金字塔',
+                date: '2025年12月04日 19:45',
+                views: 148208,
+                likes: 324,
+                collects: 2279,
+                comments: 465,
+                url: '',
+            },
+            {
+                id: '',
+                title: '终于等到了！！！',
+                date: '2026年03月18日 12:39',
+                views: 10,
+                likes: 0,
+                collects: 0,
+                comments: 0,
+                url: '',
+            },
+        ]);
+    });
+    it('reads body text and returns ranked rows', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-notes');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([
+            undefined,
+            {
+                text: `示例笔记
+发布于 2026年03月19日 12:00
+10
+2
+3
+4
+5
+权限设置`,
+                html: '"noteId":"69ba940500000000200384db"',
+            },
+        ]);
+        const result = await cmd.func(page, { limit: 1 });
+        expect(page.evaluate.mock.calls.at(-1)?.[0]).toBe('() => ({ text: document.body.innerText, html: document.body.innerHTML })');
+        expect(result).toEqual([
+            {
+                rank: 1,
+                id: '69ba940500000000200384db',
+                title: '示例笔记',
+                date: '2026年03月19日 12:00',
+                views: 10,
+                likes: 2,
+                collects: 3,
+                comments: 4,
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+            },
+        ]);
+    });
+    it('prefers the creator analyze API and preserves note ids', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-notes');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock(undefined, [{
+                data: {
+                    note_infos: [
+                        {
+                            id: '69ba940500000000200384db',
+                            title: '一张图讲清 诡秘之主·耕种者途径',
+                            post_time: new Date('2026-03-18T20:01:00+08:00').getTime(),
+                            read_count: 521,
+                            like_count: 18,
+                            fav_count: 10,
+                            comment_count: 7,
+                        },
+                    ],
+                },
+            }]);
+        const result = await cmd.func(page, { limit: 1 });
+        expect(page.installInterceptor.mock.calls[0][0]).toContain('/api/galaxy/creator/datacenter/note/analyze/list');
+        expect(result).toEqual([
+            {
+                rank: 1,
+                id: '69ba940500000000200384db',
+                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',
+            },
+        ]);
+    });
+    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>
+    `;
+        expect(parseCreatorNoteIdsFromHtml(html)).toEqual([
+            '69ba940500000000200384db',
+            '69ba2c98000000001a026e0f',
+        ]);
+    });
+});

package/dist/external.d.ts

@@ -0,0 +1,20 @@
+export interface ExternalCliInstall {
+    mac?: string;
+    linux?: string;
+    windows?: string;
+    default?: string;
+}
+export interface ExternalCliConfig {
+    name: string;
+    binary: string;
+    description?: string;
+    homepage?: string;
+    tags?: string[];
+    install?: ExternalCliInstall;
+}
+export declare function loadExternalClis(): ExternalCliConfig[];
+export declare function isBinaryInstalled(binary: string): boolean;
+export declare function getInstallCmd(installConfig?: ExternalCliInstall): string | null;
+export declare function installExternalCli(cli: ExternalCliConfig): boolean;
+export declare function executeExternalCli(name: string, args: string[]): Promise<void>;
+export declare function registerExternalCli(name: string, binary?: string, install?: string, description?: string): void;

package/dist/external.js

@@ -0,0 +1,159 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { spawnSync, execSync } from 'node:child_process';
+import yaml from 'js-yaml';
+import chalk from 'chalk';
+import { log } from './logger.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function getUserRegistryPath() {
+    const home = os.homedir();
+    return path.join(home, '.opencli', 'external-clis.yaml');
+}
+export function loadExternalClis() {
+    const configs = new Map();
+    // 1. Load built-in
+    const builtinPath = path.resolve(__dirname, 'external-clis.yaml');
+    try {
+        if (fs.existsSync(builtinPath)) {
+            const raw = fs.readFileSync(builtinPath, 'utf8');
+            const parsed = (yaml.load(raw) || []);
+            for (const item of parsed)
+                configs.set(item.name, item);
+        }
+    }
+    catch (err) {
+        log.warn(`Failed to parse built-in external-clis.yaml: ${err.message}`);
+    }
+    // 2. Load user custom
+    const userPath = getUserRegistryPath();
+    try {
+        if (fs.existsSync(userPath)) {
+            const raw = fs.readFileSync(userPath, 'utf8');
+            const parsed = (yaml.load(raw) || []);
+            for (const item of parsed) {
+                configs.set(item.name, item); // Overwrite built-in if duplicated
+            }
+        }
+    }
+    catch (err) {
+        log.warn(`Failed to parse user external-clis.yaml: ${err.message}`);
+    }
+    return Array.from(configs.values()).sort((a, b) => a.name.localeCompare(b.name));
+}
+export function isBinaryInstalled(binary) {
+    try {
+        const isWindows = os.platform() === 'win32';
+        const cmd = isWindows ? 'where' : 'command -v';
+        execSync(`${cmd} ${binary}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function getInstallCmd(installConfig) {
+    if (!installConfig)
+        return null;
+    const platform = os.platform();
+    if (platform === 'darwin' && installConfig.mac)
+        return installConfig.mac;
+    if (platform === 'linux' && installConfig.linux)
+        return installConfig.linux;
+    if (platform === 'win32' && installConfig.windows)
+        return installConfig.windows;
+    if (installConfig.default)
+        return installConfig.default;
+    return null;
+}
+export function installExternalCli(cli) {
+    if (!cli.install) {
+        console.error(chalk.red(`No auto-install command configured for '${cli.name}'.`));
+        console.error(`Please install '${cli.binary}' manually.`);
+        return false;
+    }
+    const cmd = getInstallCmd(cli.install);
+    if (!cmd) {
+        console.error(chalk.red(`No install command for your platform (${os.platform()}) for '${cli.name}'.`));
+        if (cli.homepage)
+            console.error(`See: ${cli.homepage}`);
+        return false;
+    }
+    console.log(chalk.cyan(`🔹 '${cli.name}' is not installed. Auto-installing...`));
+    console.log(chalk.dim(`$ ${cmd}`));
+    try {
+        execSync(cmd, { stdio: 'inherit' });
+        console.log(chalk.green(`✅ Installed '${cli.name}' successfully.\n`));
+        return true;
+    }
+    catch (err) {
+        console.error(chalk.red(`❌ Failed to install '${cli.name}': ${err.message}`));
+        return false;
+    }
+}
+export async function executeExternalCli(name, args) {
+    const configs = loadExternalClis();
+    const cli = configs.find((c) => c.name === name);
+    if (!cli) {
+        throw new Error(`External CLI '${name}' not found in registry.`);
+    }
+    // 1. Check if installed
+    if (!isBinaryInstalled(cli.binary)) {
+        // 2. Try to auto install
+        const success = installExternalCli(cli);
+        if (!success) {
+            process.exitCode = 1;
+            return;
+        }
+    }
+    // 3. Passthrough execution
+    // We use spawnSync to properly inherit stdio and block until completion
+    const result = spawnSync(cli.binary, args, { stdio: 'inherit' });
+    if (result.error) {
+        console.error(chalk.red(`Failed to execute '${cli.binary}': ${result.error.message}`));
+        process.exitCode = 1;
+        return;
+    }
+    if (result.status !== null) {
+        process.exitCode = result.status;
+    }
+}
+export function registerExternalCli(name, binary, install, description) {
+    const userPath = getUserRegistryPath();
+    const configDir = path.dirname(userPath);
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    let items = [];
+    if (fs.existsSync(userPath)) {
+        try {
+            const raw = fs.readFileSync(userPath, 'utf8');
+            items = (yaml.load(raw) || []);
+        }
+        catch {
+            // Ignore
+        }
+    }
+    const existingIndex = items.findIndex((c) => c.name === name);
+    const newItem = {
+        name,
+        binary: binary || name,
+    };
+    if (description)
+        newItem.description = description;
+    if (install)
+        newItem.install = { default: install };
+    if (existingIndex >= 0) {
+        // Merge
+        items[existingIndex] = { ...items[existingIndex], ...newItem };
+        console.log(chalk.green(`Updated '${name}' in user registry.`));
+    }
+    else {
+        items.push(newItem);
+        console.log(chalk.green(`Registered '${name}' in user registry.`));
+    }
+    const dump = yaml.dump(items, { indent: 2, sortKeys: true });
+    fs.writeFileSync(userPath, dump, 'utf8');
+    console.log(chalk.dim(userPath));
+}

package/docs/.vitepress/config.mts

@@ -1,7 +1,7 @@
 import { defineConfig } from 'vitepress'
 
 export default defineConfig({
-  base: '/opencli/',
+  base: '/',
   title: 'OpenCLI',
   description: 'Make any website or Electron App your CLI — AI-powered, account-safe, self-healing.',
 

package/docs/public/CNAME

@@ -0,0 +1 @@
+opencli.info