@jackwener/opencli 1.5.3 → 1.5.4

package/.agents/skills/cross-project-adapter-migration/SKILL.md

@@ -16,8 +16,8 @@ description: "Cross-project CLI command migration workflow for opencli. Use when
 
 ## Prerequisites
 
-- 熟悉 [CLI-EXPLORER.md](file:///Users/jakevin/code/opencli/CLI-EXPLORER.md)（adapter 开发决策树）
-- 熟悉 [SKILL.md](file:///Users/jakevin/code/opencli/SKILL.md)（命令参考 & 模板）
+- 熟悉 [CLI-EXPLORER.md](../../../CLI-EXPLORER.md)（adapter 开发决策树）
+- 熟悉 [SKILL.md](../../../SKILL.md)（命令参考 & 模板）
 
 ---
 
@@ -82,7 +82,7 @@ opencli list | grep <site>  # 确认已注册命令
 ## Phase 3: 批量实现
 
 > [!IMPORTANT]
-> 实现前必须查阅 [CLI-EXPLORER.md](file:///Users/jakevin/code/opencli/CLI-EXPLORER.md) 确认策略选择。
+> 实现前必须查阅 [CLI-EXPLORER.md](../../../CLI-EXPLORER.md) 确认策略选择。
 
 ### 3.1 选择实现方式
 

package/README.md

@@ -8,38 +8,233 @@
 [![Node.js Version](https://img.shields.io/node/v/@jackwener/opencli?style=flat-square)](https://nodejs.org)
 [![License](https://img.shields.io/npm/l/@jackwener/opencli?style=flat-square)](./LICENSE)
 
-A CLI tool that turns **any website**, **Electron app**, or **local CLI tool** into a command-line interface — powered by browser session reuse and AI-native discovery.
+A CLI tool that turns **any website**, **Electron app**, or **local CLI tool** into a command-line interface — Bilibili, Zhihu, 小红书, Twitter/X, Reddit, YouTube, Antigravity, `gh`, `docker`, and [many more](#built-in-commands) — powered by browser session reuse and AI-native discovery.
 
-- **Zero LLM cost** — No tokens consumed at runtime.
+**Built for AI Agents** — Configure an instruction in your `AGENT.md` or `.cursorrules` to run `opencli list` via Bash. The AI will automatically discover and invoke all available tools.
+
+**CLI Hub** — Register any local CLI (`opencli register mycli`) so AI agents can discover and call it alongside built-in commands. Auto-installs missing tools via your package manager (e.g. if `gh` isn't installed, `opencli gh ...` runs `brew install gh` first then re-executes seamlessly).
+
+**CLI for Electron Apps** — Turn any Electron application into a CLI tool. Recombine, script, and extend apps like Antigravity Ultra from the terminal. AI agents can now control other AI apps natively.
+
+---
+
+## Highlights
+
+- **CLI All Electron** — CLI-ify apps like Antigravity Ultra! Now AI can control itself natively.
 - **Account-safe** — Reuses Chrome's logged-in state; your credentials never leave the browser.
-- **Deterministic** — Same command, same output schema, every time. Pipeable, scriptable, CI-friendly.
+- **Anti-detection built-in** — Patches `navigator.webdriver`, stubs `window.chrome`, fakes plugin lists, cleans ChromeDriver/Playwright globals, and strips CDP frames from Error stack traces. Extensive anti-fingerprinting and risk-control evasion measures baked in at every layer.
 - **AI Agent ready** — `explore` discovers APIs, `synthesize` generates adapters, `cascade` finds auth strategies.
-- **65+ built-in adapters** — Global and Chinese platforms, plus desktop Electron apps via CDP.
+- **External CLI Hub** — Discover, auto-install, and passthrough commands to any external CLI (gh, obsidian, docker, etc). Zero setup.
+- **Self-healing setup** — `opencli doctor` diagnoses and auto-starts the daemon, extension, and live browser connectivity.
+- **Dynamic Loader** — Simply drop `.ts` or `.yaml` adapters into the `clis/` folder for auto-registration.
+- **Dual-Engine Architecture** — Supports both YAML declarative data pipelines and robust browser runtime TypeScript injections.
+
+## Why opencli?
+
+There are many great browser automation tools. Here's when opencli is the right choice:
+
+| Your need | Best tool | Why |
+|-----------|-----------|-----|
+| Scheduled data extraction from specific sites | **opencli** | Pre-built adapters, deterministic JSON, zero LLM cost |
+| AI agent needs reliable site operations | **opencli** | Hundreds of commands, structured output, fast deterministic response |
+| Explore an unknown website ad-hoc | Browser-Use, Stagehand | LLM-driven general browsing for one-off tasks |
+| Large-scale web crawling | Crawl4AI, Scrapy | Purpose-built for throughput and scale |
+| Control desktop Electron apps from terminal | **opencli** | CDP + AppleScript — the only CLI tool that does this |
+
+**What makes opencli different:**
+
+- **Zero LLM cost** — No tokens consumed at runtime. Run 10,000 times and pay nothing.
+- **Deterministic** — Same command, same output schema, every time. Pipeable, scriptable, CI-friendly.
+- **Broad coverage** — 50+ sites across global and Chinese platforms (Bilibili, Zhihu, Xiaohongshu, Reddit, HackerNews, and more), plus desktop Electron apps via CDP.
+
+> For a detailed comparison with Browser-Use, Crawl4AI, Firecrawl, and others, see the [Comparison Guide](./docs/comparison.md).
+
+---
 
 ## Quick Start
 
+### 1. Install Browser Bridge Extension
+
+> OpenCLI connects to your browser through a lightweight **Browser Bridge** Chrome Extension + micro-daemon (zero config, auto-start).
+
+1. Go to the GitHub [Releases page](https://github.com/jackwener/opencli/releases) and download the latest `opencli-extension.zip`.
+2. Unzip the file and open `chrome://extensions`, enable **Developer mode** (top-right toggle).
+3. Click **Load unpacked** and select the unzipped folder.
+
+### 2. Install OpenCLI
+
+**Install via npm (recommended)**
+
 ```bash
 npm install -g @jackwener/opencli
-opencli doctor                         # Check setup
+```
+
+### 3. Verify & Try
+
+```bash
+opencli doctor   # Check extension + daemon connectivity
+```
+
+**Try it out:**
+
+```bash
 opencli list                           # See all commands
 opencli hackernews top --limit 5       # Public API, no browser needed
-opencli bilibili hot -f json           # Browser command, JSON output
+opencli bilibili hot --limit 5         # Browser command (requires Extension)
 ```
 
-**[→ Full documentation](./docs/index.md)**
+### Update
+
+```bash
+npm install -g @jackwener/opencli@latest
+```
+
+---
+
+### For Developers
+
+**Install from source**
+
+```bash
+git clone git@github.com:jackwener/opencli.git && cd opencli && npm install && npm run build && npm link
+```
+
+**Load Source Browser Bridge Extension**
+
+1. Open `chrome://extensions` and enable **Developer mode** (top-right toggle).
+2. Click **Load unpacked** and select the `extension/` directory from this repository.
+
+---
+
+## Prerequisites
+
+- **Node.js**: >= 20.0.0 (or **Bun** >= 1.0)
+- **Chrome** running **and logged into the target site** (e.g. bilibili.com, zhihu.com, xiaohongshu.com).
+
+> **⚠️ Important**: Browser commands reuse your Chrome login session. You must be logged into the target website in Chrome before running commands. If you get empty data or errors, check your login status first.
+
+## Built-in Commands
+
+| Site | Commands |
+|------|----------|
+| **xiaohongshu** | `search` `feed` `user` `download` `publish` `comments` `notifications` `creator-notes` `creator-notes-summary` `creator-note-detail` `creator-profile` `creator-stats` |
+| **bilibili** | `hot` `search` `history` `feed` `ranking` `download` `comments` `dynamic` `favorite` `following` `me` `subtitle` `user-videos` |
+| **twitter** | `trending` `search` `timeline` `bookmarks` `post` `download` `profile` `article` `like` `likes` `notifications` `reply` `reply-dm` `thread` `follow` `unfollow` `followers` `following` `block` `unblock` `bookmark` `unbookmark` `delete` `hide-reply` `accept` |
+| **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `user` `user-posts` `user-comments` `read` `save` `saved` `subscribe` `upvote` `upvoted` `comment` |
+
+65+ adapters in total — **[→ see all supported sites & commands](./docs/adapters/index.md)**
+
+## CLI Hub
+
+OpenCLI acts as a universal hub for your existing command-line tools — unified discovery, pure passthrough execution, and auto-install (if a tool isn't installed, OpenCLI runs `brew install <tool>` automatically before re-running the command).
+
+| External CLI | Description | Example |
+|--------------|-------------|---------|
+| **gh** | GitHub CLI | `opencli gh pr list --limit 5` |
+| **obsidian** | Obsidian vault management | `opencli obsidian search query="AI"` |
+| **docker** | Docker | `opencli docker ps` |
+| **gws** | Google Workspace CLI | `opencli gws docs list` |
+| **lark-cli** | Lark/Feishu — messages, docs, calendar, tasks, 200+ commands | `opencli lark-cli calendar +agenda` |
+| **vercel** | Vercel — deploy projects, manage domains, env vars, logs | `opencli vercel deploy --prod` |
+
+**Register your own** — add any local CLI so AI agents can discover it via `opencli list`:
+
+```bash
+opencli register mycli
+```
+
+### Desktop App Adapters
+
+Control Electron desktop apps directly from the terminal. Each adapter has its own detailed documentation:
+
+| App | Description | Doc |
+|-----|-------------|-----|
+| **Cursor** | Control Cursor IDE — Composer, chat, code extraction | [Doc](./docs/adapters/desktop/cursor.md) |
+| **Codex** | Drive OpenAI Codex CLI agent headlessly | [Doc](./docs/adapters/desktop/codex.md) |
+| **Antigravity** | Control Antigravity Ultra from terminal | [Doc](./docs/adapters/desktop/antigravity.md) |
+| **ChatGPT** | Automate ChatGPT macOS desktop app | [Doc](./docs/adapters/desktop/chatgpt.md) |
+| **ChatWise** | Multi-LLM client (GPT-4, Claude, Gemini) | [Doc](./docs/adapters/desktop/chatwise.md) |
+| **Notion** | Search, read, write Notion pages | [Doc](./docs/adapters/desktop/notion.md) |
+| **Discord** | Discord Desktop — messages, channels, servers | [Doc](./docs/adapters/desktop/discord.md) |
+| **Doubao** | Control Doubao AI desktop app via CDP | [Doc](./docs/adapters/desktop/doubao-app.md) |
+
+To add a new Electron app, start with [docs/guide/electron-app-cli.md](./docs/guide/electron-app-cli.md).
+
+## Download Support
+
+OpenCLI supports downloading images, videos, and articles from supported platforms.
+
+| Platform | Content Types | Notes |
+|----------|---------------|-------|
+| **xiaohongshu** | Images, Videos | Downloads all media from a note |
+| **bilibili** | Videos | Requires `yt-dlp` installed |
+| **twitter** | Images, Videos | From user media tab or single tweet |
+| **douban** | Images | Poster / still image lists |
+| **pixiv** | Images | Original-quality illustrations, multi-page |
+| **zhihu** | Articles (Markdown) | Exports with optional image download |
+| **weixin** | Articles (Markdown) | WeChat Official Account articles |
+
+For video downloads, install `yt-dlp` first: `brew install yt-dlp`
+
+```bash
+opencli xiaohongshu download abc123 --output ./xhs
+opencli bilibili download BV1xxx --output ./bilibili
+opencli twitter download elonmusk --limit 20 --output ./twitter
+```
+
+## Output Formats
+
+All built-in commands support `--format` / `-f` with `table` (default), `json`, `yaml`, `md`, and `csv`.
+
+```bash
+opencli bilibili hot -f json    # Pipe to jq or LLMs
+opencli bilibili hot -f csv     # Spreadsheet-friendly
+opencli bilibili hot -v         # Verbose: show pipeline debug steps
+```
+
+## Plugins
+
+Extend OpenCLI with community-contributed adapters:
+
+```bash
+opencli plugin install github:user/opencli-plugin-my-tool
+opencli plugin list
+opencli plugin update --all
+opencli plugin uninstall my-tool
+```
+
+| Plugin | Type | Description |
+|--------|------|-------------|
+| [opencli-plugin-github-trending](https://github.com/ByteYue/opencli-plugin-github-trending) | YAML | GitHub Trending repositories |
+| [opencli-plugin-hot-digest](https://github.com/ByteYue/opencli-plugin-hot-digest) | TS | Multi-platform trending aggregator |
+| [opencli-plugin-juejin](https://github.com/Astro-Han/opencli-plugin-juejin) | YAML | 稀土掘金 (Juejin) hot articles |
+
+See [Plugins Guide](./docs/guide/plugins.md) for creating your own plugin.
+
+## For AI Agents (Developer Guide)
+
+> **Quick mode**: To generate a single command for a specific page URL, see [CLI-ONESHOT.md](./CLI-ONESHOT.md) — just a URL + one-line goal, 4 steps done.
+
+> **Full mode**: Before writing any adapter code, read [CLI-EXPLORER.md](./CLI-EXPLORER.md). It contains the complete browser exploration workflow, the 5-tier authentication strategy decision tree, and debugging guide.
+
+```bash
+opencli explore https://example.com --site mysite   # Discover APIs + capabilities
+opencli synthesize mysite                            # Generate YAML adapters
+opencli generate https://example.com --goal "hot"   # One-shot: explore → synthesize → register
+opencli cascade https://api.example.com/data         # Auto-probe: PUBLIC → COOKIE → HEADER
+```
+
+## Testing
+
+See **[TESTING.md](./TESTING.md)** for how to run and write tests.
 
-## Documentation
+## Troubleshooting
 
-| Topic | Link |
-|-------|------|
-| Installation & Setup | [docs/guide/installation.md](./docs/guide/installation.md) |
-| Getting Started | [docs/guide/getting-started.md](./docs/guide/getting-started.md) |
-| Built-in Commands | [docs/adapters/index.md](./docs/adapters/index.md) |
-| Desktop App Adapters | [docs/adapters/desktop](./docs/adapters/desktop) |
-| Plugins | [docs/guide/plugins.md](./docs/guide/plugins.md) |
-| Electron App Guide | [docs/guide/electron-app-cli.md](./docs/guide/electron-app-cli.md) |
-| Troubleshooting | [docs/guide/troubleshooting.md](./docs/guide/troubleshooting.md) |
-| Comparison with other tools | [docs/comparison.md](./docs/comparison.md) |
+- **"Extension not connected"** — Ensure the Browser Bridge extension is installed and **enabled** in `chrome://extensions`.
+- **"attach failed: Cannot access a chrome-extension:// URL"** — Another extension may be interfering. Try disabling other extensions temporarily.
+- **Empty data or 'Unauthorized' error** — Your Chrome login session may have expired. Navigate to the target site and log in again.
+- **Node API errors** — Ensure Node.js >= 20. Some dependencies require modern Node APIs.
+- **Daemon issues** — Check status: `curl localhost:19825/status` · View logs: `curl localhost:19825/logs`
 
 ## Star History
 

package/dist/build-manifest.d.ts

@@ -36,11 +36,10 @@ export interface ManifestEntry {
     /** Pre-navigation control — see CliCommand.navigateBefore */
     navigateBefore?: boolean | string;
 }
-export declare function parseTsArgsBlock(argsBlock: string): ManifestEntry['args'];
-export declare function scanTs(filePath: string, site: string): ManifestEntry | null;
+export declare function loadTsManifestEntries(filePath: string, site: string, importer?: (moduleHref: string) => Promise<unknown>): Promise<ManifestEntry[]>;
 /**
  * When both YAML and TS adapters exist for the same site/name,
  * prefer the TS version (it self-registers and typically has richer logic).
  */
 export declare function shouldReplaceManifestEntry(current: ManifestEntry, next: ManifestEntry): boolean;
-export declare function buildManifest(): ManifestEntry[];
+export declare function buildManifest(): Promise<ManifestEntry[]>;

package/dist/build-manifest.js

@@ -13,109 +13,52 @@ import * as path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import yaml from 'js-yaml';
 import { getErrorMessage } from './errors.js';
+import { fullName, getRegistry } from './registry.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const CLIS_DIR = path.resolve(__dirname, 'clis');
 const OUTPUT = path.resolve(__dirname, '..', 'dist', 'cli-manifest.json');
 import { parseYamlArgs } from './yaml-schema.js';
 import { isRecord } from './utils.js';
-function extractBalancedBlock(source, startIndex, openChar, closeChar) {
-    let depth = 0;
-    let quote = null;
-    let escaped = false;
-    for (let i = startIndex; i < source.length; i++) {
-        const ch = source[i];
-        if (quote) {
-            if (escaped) {
-                escaped = false;
-                continue;
-            }
-            if (ch === '\\') {
-                escaped = true;
-                continue;
-            }
-            if (ch === quote)
-                quote = null;
-            continue;
-        }
-        if (ch === '"' || ch === '\'' || ch === '`') {
-            quote = ch;
-            continue;
-        }
-        if (ch === openChar) {
-            depth++;
-        }
-        else if (ch === closeChar) {
-            depth--;
-            if (depth === 0) {
-                return source.slice(startIndex + 1, i);
-            }
-        }
-    }
-    return null;
+const CLI_MODULE_PATTERN = /\bcli\s*\(/;
+function toManifestArgs(args) {
+    return args.map(arg => ({
+        name: arg.name,
+        type: arg.type ?? 'str',
+        default: arg.default,
+        required: !!arg.required,
+        positional: arg.positional || undefined,
+        help: arg.help ?? '',
+        choices: arg.choices,
+    }));
 }
-function extractTsArgsBlock(source) {
-    const argsMatch = source.match(/args\s*:/);
-    if (!argsMatch || argsMatch.index === undefined)
-        return null;
-    const bracketIndex = source.indexOf('[', argsMatch.index);
-    if (bracketIndex === -1)
-        return null;
-    return extractBalancedBlock(source, bracketIndex, '[', ']');
+function toTsModulePath(filePath, site) {
+    const baseName = path.basename(filePath, path.extname(filePath));
+    return `${site}/${baseName}.js`;
 }
-function parseInlineChoices(body) {
-    const choicesMatch = body.match(/choices\s*:\s*\[([^\]]*)\]/);
-    if (!choicesMatch)
-        return undefined;
-    const values = choicesMatch[1]
-        .split(',')
-        .map(s => s.trim().replace(/^['"`]|['"`]$/g, ''))
-        .filter(Boolean);
-    return values.length > 0 ? values : undefined;
+function isCliCommandValue(value, site) {
+    return isRecord(value)
+        && typeof value.site === 'string'
+        && value.site === site
+        && typeof value.name === 'string'
+        && Array.isArray(value.args);
 }
-export function parseTsArgsBlock(argsBlock) {
-    const args = [];
-    let cursor = 0;
-    while (cursor < argsBlock.length) {
-        const nameMatch = argsBlock.slice(cursor).match(/\{\s*name\s*:\s*['"`]([^'"`]+)['"`]/);
-        if (!nameMatch || nameMatch.index === undefined)
-            break;
-        const objectStart = cursor + nameMatch.index;
-        const body = extractBalancedBlock(argsBlock, objectStart, '{', '}');
-        if (body == null)
-            break;
-        const typeMatch = body.match(/type\s*:\s*['"`](\w+)['"`]/);
-        const defaultMatch = body.match(/default\s*:\s*([^,}]+)/);
-        const requiredMatch = body.match(/required\s*:\s*(true|false)/);
-        const helpMatch = body.match(/help\s*:\s*['"`]([^'"`]*)['"`]/);
-        const positionalMatch = body.match(/positional\s*:\s*(true|false)/);
-        let defaultVal = undefined;
-        if (defaultMatch) {
-            const raw = defaultMatch[1].trim();
-            if (raw === 'true')
-                defaultVal = true;
-            else if (raw === 'false')
-                defaultVal = false;
-            else if (/^\d+$/.test(raw))
-                defaultVal = parseInt(raw, 10);
-            else if (/^\d+\.\d+$/.test(raw))
-                defaultVal = parseFloat(raw);
-            else
-                defaultVal = raw.replace(/^['"`]|['"`]$/g, '');
-        }
-        args.push({
-            name: nameMatch[1],
-            type: typeMatch?.[1] ?? 'str',
-            default: defaultVal,
-            required: requiredMatch?.[1] === 'true',
-            positional: positionalMatch?.[1] === 'true' || undefined,
-            help: helpMatch?.[1] ?? '',
-            choices: parseInlineChoices(body),
-        });
-        cursor = objectStart + body.length;
-        if (cursor <= objectStart)
-            break; // safety: prevent infinite loop
-    }
-    return args;
+function toManifestEntry(cmd, modulePath) {
+    return {
+        site: cmd.site,
+        name: cmd.name,
+        description: cmd.description ?? '',
+        domain: cmd.domain,
+        strategy: (cmd.strategy ?? 'public').toString().toLowerCase(),
+        browser: cmd.browser ?? true,
+        args: toManifestArgs(cmd.args),
+        columns: cmd.columns,
+        timeout: cmd.timeoutSeconds,
+        deprecated: cmd.deprecated,
+        replacedBy: cmd.replacedBy,
+        type: 'ts',
+        modulePath,
+        navigateBefore: cmd.navigateBefore,
+    };
 }
 function scanYaml(filePath, site) {
     try {
@@ -150,82 +93,44 @@ function scanYaml(filePath, site) {
         return null;
     }
 }
-export function scanTs(filePath, site) {
-    // TS adapters self-register via cli() at import time.
-    // We statically parse the source to extract metadata for the manifest stub.
-    const baseName = path.basename(filePath, path.extname(filePath));
-    const relativePath = `${site}/${baseName}.js`;
+export async function loadTsManifestEntries(filePath, site, importer = moduleHref => import(moduleHref)) {
     try {
         const src = fs.readFileSync(filePath, 'utf-8');
         // Helper/test modules should not appear as CLI commands in the manifest.
-        if (!/\bcli\s*\(/.test(src))
-            return null;
-        const entry = {
-            site,
-            name: baseName,
-            description: '',
-            strategy: 'cookie',
-            browser: true,
-            args: [],
-            type: 'ts',
-            modulePath: relativePath,
-        };
-        // Extract description
-        const descMatch = src.match(/description\s*:\s*['"`]([^'"`]*)['"`]/);
-        if (descMatch)
-            entry.description = descMatch[1];
-        // Extract domain
-        const domainMatch = src.match(/domain\s*:\s*['"`]([^'"`]*)['"`]/);
-        if (domainMatch)
-            entry.domain = domainMatch[1];
-        // Extract strategy
-        const stratMatch = src.match(/strategy\s*:\s*Strategy\.(\w+)/);
-        if (stratMatch)
-            entry.strategy = stratMatch[1].toLowerCase();
-        // Extract browser: false (some adapters bypass browser entirely)
-        const browserMatch = src.match(/browser\s*:\s*(true|false)/);
-        if (browserMatch)
-            entry.browser = browserMatch[1] === 'true';
-        else
-            entry.browser = entry.strategy !== 'public';
-        // Extract columns
-        const colMatch = src.match(/columns\s*:\s*\[([^\]]*)\]/);
-        if (colMatch) {
-            entry.columns = colMatch[1].split(',').map(s => s.trim().replace(/^['"`]|['"`]$/g, '')).filter(Boolean);
-        }
-        // Extract args array items: { name: '...', ... }
-        const argsBlock = extractTsArgsBlock(src);
-        if (argsBlock) {
-            entry.args = parseTsArgsBlock(argsBlock);
-        }
-        // Extract navigateBefore: false / true / 'https://...'
-        const navBoolMatch = src.match(/navigateBefore\s*:\s*(true|false)/);
-        if (navBoolMatch) {
-            entry.navigateBefore = navBoolMatch[1] === 'true';
-        }
-        else {
-            const navStringMatch = src.match(/navigateBefore\s*:\s*['"`]([^'"`]+)['"`]/);
-            if (navStringMatch)
-                entry.navigateBefore = navStringMatch[1];
-        }
-        const deprecatedBoolMatch = src.match(/deprecated\s*:\s*(true|false)/);
-        if (deprecatedBoolMatch) {
-            entry.deprecated = deprecatedBoolMatch[1] === 'true';
-        }
-        else {
-            const deprecatedStringMatch = src.match(/deprecated\s*:\s*['"`]([^'"`]+)['"`]/);
-            if (deprecatedStringMatch)
-                entry.deprecated = deprecatedStringMatch[1];
-        }
-        const replacedByMatch = src.match(/replacedBy\s*:\s*['"`]([^'"`]+)['"`]/);
-        if (replacedByMatch)
-            entry.replacedBy = replacedByMatch[1];
-        return entry;
+        if (!CLI_MODULE_PATTERN.test(src))
+            return [];
+        const modulePath = toTsModulePath(filePath, site);
+        const registry = getRegistry();
+        const before = new Map(registry.entries());
+        const mod = await importer(pathToFileURL(filePath).href);
+        const exportedCommands = Object.values(isRecord(mod) ? mod : {})
+            .filter(value => isCliCommandValue(value, site));
+        const runtimeCommands = exportedCommands.length > 0
+            ? exportedCommands
+            : [...registry.entries()]
+                .filter(([key, cmd]) => {
+                if (cmd.site !== site)
+                    return false;
+                const previous = before.get(key);
+                return !previous || previous !== cmd;
+            })
+                .map(([, cmd]) => cmd);
+        const seen = new Set();
+        return runtimeCommands
+            .filter((cmd) => {
+            const key = fullName(cmd);
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        })
+            .sort((a, b) => a.name.localeCompare(b.name))
+            .map(cmd => toManifestEntry(cmd, modulePath));
     }
     catch (err) {
         // If parsing fails, log a warning (matching scanYaml behaviour) and skip the entry.
         process.stderr.write(`Warning: failed to scan ${filePath}: ${getErrorMessage(err)}\n`);
-        return null;
+        return [];
     }
 }
 /**
@@ -237,7 +142,7 @@ export function shouldReplaceManifestEntry(current, next) {
         return false;
     return current.type === 'yaml' && next.type === 'ts';
 }
-export function buildManifest() {
+export async function buildManifest() {
     const manifest = new Map();
     if (fs.existsSync(CLIS_DIR)) {
         for (const site of fs.readdirSync(CLIS_DIR)) {
@@ -261,8 +166,8 @@ export function buildManifest() {
                 }
                 else if ((file.endsWith('.ts') && !file.endsWith('.d.ts') && !file.endsWith('.test.ts') && file !== 'index.ts') ||
                     (file.endsWith('.js') && !file.endsWith('.d.js') && !file.endsWith('.test.js') && file !== 'index.js')) {
-                    const entry = scanTs(filePath, site);
-                    if (entry) {
+                    const entries = await loadTsManifestEntries(filePath, site);
+                    for (const entry of entries) {
                         const key = `${entry.site}/${entry.name}`;
                         const existing = manifest.get(key);
                         if (!existing || shouldReplaceManifestEntry(existing, entry)) {
@@ -278,8 +183,8 @@ export function buildManifest() {
     }
     return [...manifest.values()];
 }
-function main() {
-    const manifest = buildManifest();
+async function main() {
+    const manifest = await buildManifest();
     fs.mkdirSync(path.dirname(OUTPUT), { recursive: true });
     fs.writeFileSync(OUTPUT, JSON.stringify(manifest, null, 2));
     const yamlCount = manifest.filter(e => e.type === 'yaml').length;
@@ -311,5 +216,5 @@ function main() {
 }
 const entrypoint = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : null;
 if (entrypoint === import.meta.url) {
-    main();
+    void main();
 }