@jackwener/opencli 1.5.0 → 1.5.2

package/dist/runtime.d.ts

@@ -13,6 +13,7 @@ export declare const DEFAULT_BROWSER_EXPLORE_TIMEOUT: number;
 export declare function runWithTimeout<T>(promise: Promise<T>, opts: {
     timeout: number;
     label?: string;
+    hint?: string;
 }): Promise<T>;
 /**
  * Timeout with milliseconds unit. Used for low-level internal timeouts.

package/dist/runtime.js

@@ -26,7 +26,7 @@ export const DEFAULT_BROWSER_EXPLORE_TIMEOUT = parseEnvTimeout('OPENCLI_BROWSER_
  */
 export async function runWithTimeout(promise, opts) {
     const label = opts.label ?? 'Operation';
-    return withTimeoutMs(promise, opts.timeout * 1000, () => new TimeoutError(label, opts.timeout));
+    return withTimeoutMs(promise, opts.timeout * 1000, () => new TimeoutError(label, opts.timeout, opts.hint));
 }
 /**
  * Timeout with milliseconds unit. Used for low-level internal timeouts.

package/dist/types.d.ts

@@ -69,4 +69,6 @@ export interface IPage {
     getInterceptedRequests(): Promise<any[]>;
     screenshot(options?: ScreenshotOptions): Promise<string>;
     closeWindow?(): Promise<void>;
+    /** Returns the current page URL, or null if unavailable. */
+    getCurrentUrl?(): Promise<string | null>;
 }

package/dist/weread-private-api-regression.test.js

@@ -44,6 +44,21 @@ describe('weread private API regression', () => {
         }));
         await expect(fetchPrivateApi(mockPage, '/book/info')).rejects.toThrow('Not logged in');
     });
+    it('maps auth-expired API error codes to AUTH_REQUIRED even on HTTP 200', async () => {
+        const mockPage = {
+            getCookies: vi.fn().mockResolvedValue([]),
+            evaluate: vi.fn(),
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: () => Promise.resolve({ errcode: -2012, errmsg: '登录超时' }),
+        }));
+        await expect(fetchPrivateApi(mockPage, '/book/info')).rejects.toMatchObject({
+            code: 'AUTH_REQUIRED',
+            message: 'Not logged in to WeRead',
+        });
+    });
     it('maps non-auth API errors to API_ERROR', async () => {
         const mockPage = {
             getCookies: vi.fn().mockResolvedValue([]),
@@ -119,4 +134,174 @@ describe('weread private API regression', () => {
             },
         ]);
     });
+    it('falls back to structured shelf cache when the private API reports AUTH_REQUIRED', async () => {
+        const command = getRegistry().get('weread/shelf');
+        expect(command?.func).toBeTypeOf('function');
+        const mockPage = {
+            getCookies: vi.fn()
+                .mockResolvedValueOnce([
+                { name: 'wr_skey', value: 'skey123', domain: '.weread.qq.com' },
+            ])
+                .mockResolvedValueOnce([
+                { name: 'wr_vid', value: 'vid-current', domain: '.weread.qq.com' },
+            ]),
+            goto: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn().mockImplementation(async (source) => {
+                expect(source).toContain('shelf:rawBooks:vid-current');
+                expect(source).toContain('shelf:shelfIndexes:vid-current');
+                return {
+                    cacheFound: true,
+                    rawBooks: [
+                        {
+                            bookId: '40055543',
+                            title: '置身事内：中国政府与经济发展',
+                            author: '兰小欢',
+                        },
+                        {
+                            bookId: '29196155',
+                            title: '文明、现代化、价值投资与中国',
+                            author: '李录',
+                        },
+                    ],
+                    shelfIndexes: [
+                        { bookId: '29196155', idx: 0, role: 'book' },
+                        { bookId: '40055543', idx: 1, role: 'book' },
+                    ],
+                    lastChapters: {
+                        '29196155': 40,
+                        '40055543': 60,
+                    },
+                };
+            }),
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+            json: () => Promise.resolve({ errcode: -2012, errmsg: '登录超时' }),
+        }));
+        const result = await command.func(mockPage, { limit: 1 });
+        expect(mockPage.goto).toHaveBeenCalledWith('https://weread.qq.com/web/shelf');
+        expect(mockPage.getCookies).toHaveBeenCalledWith({ domain: 'weread.qq.com' });
+        expect(mockPage.evaluate).toHaveBeenCalledTimes(1);
+        expect(result).toEqual([
+            {
+                title: '文明、现代化、价值投资与中国',
+                author: '李录',
+                progress: '-',
+                bookId: '29196155',
+            },
+        ]);
+    });
+    it('rethrows AUTH_REQUIRED when the current session has no structured shelf cache', async () => {
+        const command = getRegistry().get('weread/shelf');
+        expect(command?.func).toBeTypeOf('function');
+        const mockPage = {
+            getCookies: vi.fn()
+                .mockResolvedValueOnce([
+                { name: 'wr_skey', value: 'skey123', domain: '.weread.qq.com' },
+            ])
+                .mockResolvedValueOnce([
+                { name: 'wr_vid', value: 'vid-current', domain: '.weread.qq.com' },
+            ]),
+            goto: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn().mockResolvedValue({
+                cacheFound: false,
+                rawBooks: [],
+                shelfIndexes: [],
+                lastChapters: {},
+            }),
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+            json: () => Promise.resolve({ errcode: -2012, errmsg: '登录超时' }),
+        }));
+        await expect(command.func(mockPage, { limit: 20 })).rejects.toMatchObject({
+            code: 'AUTH_REQUIRED',
+            message: 'Not logged in to WeRead',
+        });
+        expect(mockPage.goto).toHaveBeenCalledWith('https://weread.qq.com/web/shelf');
+        expect(mockPage.getCookies).toHaveBeenCalledWith({ domain: 'weread.qq.com' });
+    });
+    it('returns an empty list when the current session cache is confirmed but empty', async () => {
+        const command = getRegistry().get('weread/shelf');
+        expect(command?.func).toBeTypeOf('function');
+        const mockPage = {
+            getCookies: vi.fn()
+                .mockResolvedValueOnce([
+                { name: 'wr_skey', value: 'skey123', domain: '.weread.qq.com' },
+            ])
+                .mockResolvedValueOnce([
+                { name: 'wr_vid', value: 'vid-current', domain: '.weread.qq.com' },
+            ]),
+            goto: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn().mockResolvedValue({
+                cacheFound: true,
+                rawBooks: [],
+                shelfIndexes: [],
+                lastChapters: {},
+            }),
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+            json: () => Promise.resolve({ errcode: -2012, errmsg: '登录超时' }),
+        }));
+        const result = await command.func(mockPage, { limit: 20 });
+        expect(mockPage.goto).toHaveBeenCalledWith('https://weread.qq.com/web/shelf');
+        expect(mockPage.getCookies).toHaveBeenCalledWith({ domain: 'weread.qq.com' });
+        expect(result).toEqual([]);
+    });
+    it('falls back to raw book cache order when shelf indexes are unavailable', async () => {
+        const command = getRegistry().get('weread/shelf');
+        expect(command?.func).toBeTypeOf('function');
+        const mockPage = {
+            getCookies: vi.fn()
+                .mockResolvedValueOnce([
+                { name: 'wr_skey', value: 'skey123', domain: '.weread.qq.com' },
+            ])
+                .mockResolvedValueOnce([
+                { name: 'wr_vid', value: 'vid-current', domain: '.weread.qq.com' },
+            ]),
+            goto: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn().mockResolvedValue({
+                cacheFound: true,
+                rawBooks: [
+                    {
+                        bookId: '40055543',
+                        title: '置身事内：中国政府与经济发展',
+                        author: '兰小欢',
+                    },
+                    {
+                        bookId: '29196155',
+                        title: '文明、现代化、价值投资与中国',
+                        author: '李录',
+                    },
+                ],
+                shelfIndexes: [],
+            }),
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+            json: () => Promise.resolve({ errcode: -2012, errmsg: '登录超时' }),
+        }));
+        const result = await command.func(mockPage, { limit: 2 });
+        expect(mockPage.getCookies).toHaveBeenCalledWith({ url: 'https://i.weread.qq.com/shelf/sync?synckey=0&lectureSynckey=0' });
+        expect(mockPage.getCookies).toHaveBeenCalledWith({ domain: 'weread.qq.com' });
+        expect(result).toEqual([
+            {
+                title: '置身事内：中国政府与经济发展',
+                author: '兰小欢',
+                progress: '-',
+                bookId: '40055543',
+            },
+            {
+                title: '文明、现代化、价值投资与中国',
+                author: '李录',
+                progress: '-',
+                bookId: '29196155',
+            },
+        ]);
+    });
 });

package/docs/adapters/browser/bluesky.md

@@ -0,0 +1,53 @@
+# Bluesky
+
+**Mode**: 🌐 Public · **Domain**: `bsky.app`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli bluesky profile` | User profile info |
+| `opencli bluesky user` | Recent posts from a user |
+| `opencli bluesky trending` | Trending topics |
+| `opencli bluesky search` | Search users |
+| `opencli bluesky feeds` | Popular feed generators |
+| `opencli bluesky followers` | User's followers |
+| `opencli bluesky following` | Accounts a user follows |
+| `opencli bluesky thread` | Post thread with replies |
+| `opencli bluesky starter-packs` | User's starter packs |
+
+## Usage Examples
+
+```bash
+# User profile
+opencli bluesky profile --handle bsky.app
+
+# Recent posts
+opencli bluesky user --handle bsky.app --limit 10
+
+# Trending topics
+opencli bluesky trending --limit 10
+
+# Search users
+opencli bluesky search --query "AI" --limit 10
+
+# Popular feeds
+opencli bluesky feeds --limit 10
+
+# Followers / following
+opencli bluesky followers --handle bsky.app --limit 10
+opencli bluesky following --handle bsky.app
+
+# Post thread with replies
+opencli bluesky thread --uri "at://did:.../app.bsky.feed.post/..."
+
+# Starter packs
+opencli bluesky starter-packs --handle bsky.app
+
+# JSON output
+opencli bluesky profile --handle bsky.app -f json
+```
+
+## Prerequisites
+
+None — all commands use the public Bluesky AT Protocol API, no browser or login required.

package/docs/guide/plugins.md

@@ -31,9 +31,19 @@ Plugins live in `~/.opencli/plugins/<name>/`. Each subdirectory is scanned at st
 ### Supported Source Formats
 
 ```bash
+# GitHub shorthand
 opencli plugin install github:user/repo
 opencli plugin install github:user/repo/subplugin   # install specific sub-plugin from monorepo
 opencli plugin install https://github.com/user/repo
+
+# Any git-cloneable URL
+opencli plugin install https://gitlab.example.com/team/repo.git
+opencli plugin install ssh://git@gitlab.example.com/team/repo.git
+opencli plugin install git@gitlab.example.com:team/repo.git
+
+# Local plugin (for development)
+opencli plugin install file:///path/to/plugin
+opencli plugin install /path/to/plugin
 ```
 
 The repo name prefix `opencli-plugin-` is automatically stripped for the local directory name. For example, `opencli-plugin-hot-digest` becomes `hot-digest`.

package/extension/dist/background.js

@@ -164,6 +164,7 @@ function connect() {
       clearTimeout(reconnectTimer);
       reconnectTimer = null;
     }
+    ws?.send(JSON.stringify({ type: "hello", version: chrome.runtime.getManifest().version }));
   };
   ws.onmessage = async (event) => {
     try {
@@ -195,7 +196,7 @@ function scheduleReconnect() {
   }, delay);
 }
 const automationSessions = /* @__PURE__ */ new Map();
-const WINDOW_IDLE_TIMEOUT = 12e4;
+const WINDOW_IDLE_TIMEOUT = 3e4;
 function getWorkspaceKey(workspace) {
   return workspace?.trim() || "default";
 }
@@ -230,7 +231,8 @@ async function getAutomationWindow(workspace) {
     focused: false,
     width: 1280,
     height: 900,
-    type: "normal"
+    type: "normal",
+    state: "minimized"
   });
   const session = {
     windowId: win.id,

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "OpenCLI",
-  "version": "1.4.1",
+  "version": "1.5.2",
   "description": "Browser automation bridge for the OpenCLI CLI tool. Executes commands in isolated Chrome windows via a local daemon.",
   "permissions": [
     "debugger",
@@ -10,6 +10,9 @@
     "activeTab",
     "alarms"
   ],
+  "host_permissions": [
+    "<all_urls>"
+  ],
   "background": {
     "service_worker": "dist/background.js",
     "type": "module"

package/extension/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "opencli-extension",
-  "version": "0.2.0",
+  "version": "1.5.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "opencli-extension",
-      "version": "0.2.0",
+      "version": "1.5.2",
       "devDependencies": {
         "@types/chrome": "^0.0.287",
         "typescript": "^5.7.0",

package/extension/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencli-extension",
-  "version": "1.4.1",
+  "version": "1.5.2",
   "private": true,
   "type": "module",
   "scripts": {

package/extension/src/background.ts

@@ -106,7 +106,7 @@ type AutomationSession = {
 };
 
 const automationSessions = new Map<string, AutomationSession>();
-const WINDOW_IDLE_TIMEOUT = 120000; // 120s — longer to survive slow pipelines
+const WINDOW_IDLE_TIMEOUT = 30000; // 30s — quick cleanup after command finishes
 
 function getWorkspaceKey(workspace?: string): string {
   return workspace?.trim() || 'default';
@@ -152,6 +152,7 @@ async function getAutomationWindow(workspace: string): Promise<number> {
     width: 1280,
     height: 900,
     type: 'normal',
+    state: 'minimized',
   });
   const session: AutomationSession = {
     windowId: win.id!,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackwener/opencli",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "publishConfig": {
     "access": "public"
   },

package/src/browser/cdp.ts

@@ -173,6 +173,7 @@ export class CDPBridge implements IBrowserFactory {
 
 class CDPPage implements IPage {
   private _pageEnabled = false;
+  private _lastUrl: string | null = null;
   constructor(private bridge: CDPBridge) {}
 
   async goto(url: string, options?: { waitUntil?: 'load' | 'none'; settleMs?: number }): Promise<void> {
@@ -183,6 +184,7 @@ class CDPPage implements IPage {
     const loadPromise = this.bridge.waitForEvent('Page.loadEventFired', 30_000).catch(() => {});
     await this.bridge.send('Page.navigate', { url });
     await loadPromise;
+    this._lastUrl = url;
     if (options?.waitUntil !== 'none') {
       const maxMs = options?.settleMs ?? 1000;
       await this.evaluate(waitForDomStableJs(maxMs, Math.min(500, maxMs)));
@@ -307,6 +309,10 @@ class CDPPage implements IPage {
     return [];
   }
 
+  async getCurrentUrl(): Promise<string | null> {
+    return this._lastUrl;
+  }
+
   async installInterceptor(pattern: string): Promise<void> {
     const { generateInterceptorJs } = await import('../interceptor.js');
     await this.evaluate(generateInterceptorJs(JSON.stringify(pattern), {

package/src/browser/discover.ts

@@ -22,13 +22,16 @@ export async function checkDaemonStatus(opts?: { timeout?: number }): Promise<{
     const port = parseInt(process.env.OPENCLI_DAEMON_PORT ?? String(DEFAULT_DAEMON_PORT), 10);
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), opts?.timeout ?? 2000);
-    const res = await fetch(`http://127.0.0.1:${port}/status`, {
-      headers: { 'X-OpenCLI': '1' },
-      signal: controller.signal,
-    });
-    const data = await res.json() as { ok: boolean; extensionConnected: boolean; extensionVersion?: string };
-    clearTimeout(timer);
-    return { running: true, extensionConnected: data.extensionConnected, extensionVersion: data.extensionVersion };
+    try {
+      const res = await fetch(`http://127.0.0.1:${port}/status`, {
+        headers: { 'X-OpenCLI': '1' },
+        signal: controller.signal,
+      });
+      const data = await res.json() as { ok: boolean; extensionConnected: boolean; extensionVersion?: string };
+      return { running: true, extensionConnected: data.extensionConnected, extensionVersion: data.extensionVersion };
+    } finally {
+      clearTimeout(timer);
+    }
   } catch {
     return { running: false, extensionConnected: false };
   }

package/src/browser/index.ts

@@ -15,6 +15,7 @@ export type { DomSnapshotOptions } from './dom-snapshot.js';
 
 import { extractTabEntries, diffTabIndexes, appendLimited } from './tabs.js';
 import { __test__ as cdpTest } from './cdp.js';
+import { isRetryableSettleError } from './page.js';
 import { withTimeoutMs } from '../runtime.js';
 
 export const __test__ = {
@@ -24,4 +25,5 @@ export const __test__ = {
   withTimeoutMs,
   selectCDPTarget: cdpTest.selectCDPTarget,
   scoreCDPTarget: cdpTest.scoreCDPTarget,
+  isRetryableSettleError,
 };

package/src/browser/page.ts

@@ -28,6 +28,12 @@ import {
   waitForDomStableJs,
 } from './dom-helpers.js';
 
+export function isRetryableSettleError(err: unknown): boolean {
+  const message = err instanceof Error ? err.message : String(err);
+  return message.includes('Inspected target navigated or closed')
+    || (message.includes('-32000') && message.toLowerCase().includes('target'));
+}
+
 /**
  * Page — implements IPage by talking to the daemon via HTTP.
  */
@@ -36,6 +42,8 @@ export class Page implements IPage {
 
   /** Active tab ID, set after navigate and used in all subsequent commands */
   private _tabId: number | undefined;
+  /** Last navigated URL, tracked in-memory to avoid extra round-trips */
+  private _lastUrl: string | null = null;
 
   /** Helper: spread workspace into command params */
   private _wsOpt(): { workspace: string } {
@@ -55,10 +63,11 @@ export class Page implements IPage {
       url,
       ...this._cmdOpts(),
     }) as { tabId?: number };
-    // Remember the tabId for subsequent exec calls
+    // Remember the tabId and URL for subsequent calls
     if (result?.tabId) {
       this._tabId = result.tabId;
     }
+    this._lastUrl = url;
     // Inject stealth anti-detection patches (guard flag prevents double-injection).
     try {
       await sendCommand('exec', {
@@ -72,13 +81,34 @@ export class Page implements IPage {
     // settleMs is now a timeout cap (default 1000ms), not a fixed wait.
     if (options?.waitUntil !== 'none') {
       const maxMs = options?.settleMs ?? 1000;
-      await sendCommand('exec', {
+      const settleOpts = {
         code: waitForDomStableJs(maxMs, Math.min(500, maxMs)),
         ...this._cmdOpts(),
-      });
+      };
+      try {
+        await sendCommand('exec', settleOpts);
+      } catch (err) {
+        if (!isRetryableSettleError(err)) throw err;
+        // SPA client-side redirects can invalidate the CDP target after
+        // chrome.tabs reports 'complete'. Wait briefly for the new document
+        // to load, then retry the settle probe once.
+        try {
+          await new Promise((r) => setTimeout(r, 200));
+          await sendCommand('exec', settleOpts);
+        } catch (retryErr) {
+          if (!isRetryableSettleError(retryErr)) throw retryErr;
+          // Retry also failed — give up silently. Settle is best-effort
+          // after successful navigation; the next real command will surface
+          // any persistent target error immediately.
+        }
+      }
     }
   }
 
+  async getCurrentUrl(): Promise<string | null> {
+    return this._lastUrl;
+  }
+
   /** Close the automation window in the extension */
   async closeWindow(): Promise<void> {
     try {
@@ -183,6 +213,22 @@ export class Page implements IPage {
 
   async wait(options: number | WaitOptions): Promise<void> {
     if (typeof options === 'number') {
+      if (options >= 1) {
+        // For waits >= 1s, use DOM-stable check: return early when the page
+        // stops mutating, with the original wait time as the hard cap.
+        // This turns e.g. `page.wait(5)` from a fixed 5s sleep into
+        // "wait until DOM is stable, max 5s" — often completing in <1s.
+        try {
+          const maxMs = options * 1000;
+          await sendCommand('exec', {
+            code: waitForDomStableJs(maxMs, Math.min(500, maxMs)),
+            ...this._cmdOpts(),
+          });
+          return;
+        } catch {
+          // Fallback: fixed sleep (e.g. if page has no DOM yet)
+        }
+      }
       await new Promise(resolve => setTimeout(resolve, options * 1000));
       return;
     }

package/src/browser.test.ts

@@ -45,6 +45,12 @@ describe('browser helpers', () => {
     await expect(__test__.withTimeoutMs(new Promise(() => {}), 10, 'timeout')).rejects.toThrow('timeout');
   });
 
+  it('retries settle only for target-invalidated errors', () => {
+    expect(__test__.isRetryableSettleError(new Error('{"code":-32000,"message":"Inspected target navigated or closed"}'))).toBe(true);
+    expect(__test__.isRetryableSettleError(new Error('attach failed: target no longer exists'))).toBe(false);
+    expect(__test__.isRetryableSettleError(new Error('malformed exec payload'))).toBe(false);
+  });
+
   it('prefers the real Electron app target over DevTools and blank pages', () => {
     const target = __test__.selectCDPTarget([
       {

package/src/cli.ts

@@ -76,9 +76,10 @@ export function runCli(BUILTIN_CLIS: string, USER_CLIS: string): void {
       for (const [site, cmds] of sites) {
         console.log(chalk.bold.cyan(`  ${site}`));
         for (const cmd of cmds) {
-          const tag = strategyLabel(cmd) === 'public'
+          const label = strategyLabel(cmd);
+          const tag = label === 'public'
             ? chalk.green('[public]')
-            : chalk.yellow(`[${strategyLabel(cmd)}]`);
+            : chalk.yellow(`[${label}]`);
           console.log(`    ${cmd.name} ${tag}${cmd.description ? chalk.dim(` — ${cmd.description}`) : ''}`);
         }
         console.log();
@@ -252,7 +253,7 @@ export function runCli(BUILTIN_CLIS: string, USER_CLIS: string): void {
 
   pluginCmd
     .command('install')
-    .description('Install a plugin from GitHub')
+    .description('Install a plugin from a git repository')
     .argument('<source>', 'Plugin source (e.g. github:user/repo)')
     .action(async (source: string) => {
       const { installPlugin } = await import('./plugin.js');
@@ -411,6 +412,36 @@ export function runCli(BUILTIN_CLIS: string, USER_CLIS: string): void {
       console.log();
     });
 
+  pluginCmd
+    .command('create')
+    .description('Create a new plugin scaffold')
+    .argument('<name>', 'Plugin name (lowercase, hyphens allowed)')
+    .option('-d, --dir <path>', 'Output directory (default: ./<name>)')
+    .option('--description <text>', 'Plugin description')
+    .action(async (name: string, opts: { dir?: string; description?: string }) => {
+      const { createPluginScaffold } = await import('./plugin-scaffold.js');
+      try {
+        const result = createPluginScaffold(name, {
+          dir: opts.dir,
+          description: opts.description,
+        });
+        console.log(chalk.green(`✅ Plugin scaffold created at ${result.dir}`));
+        console.log();
+        console.log(chalk.bold('  Files created:'));
+        for (const f of result.files) {
+          console.log(`    ${chalk.cyan(f)}`);
+        }
+        console.log();
+        console.log(chalk.dim('  Next steps:'));
+        console.log(chalk.dim(`    cd ${result.dir}`));
+        console.log(chalk.dim(`    opencli plugin install file://${result.dir}`));
+        console.log(chalk.dim(`    opencli ${name} hello`));
+      } catch (err) {
+        console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
+        process.exitCode = 1;
+      }
+    });
+
   // ── External CLIs ─────────────────────────────────────────────────────────
 
   const externalClis = loadExternalClis();