skillops-cli 1.3.1 → 1.3.3

package/dist/cli.js

@@ -10,7 +10,7 @@ import YAML6 from "yaml";
 import fs from "fs";
 import YAML from "yaml";
 import { z } from "zod";
-var SKILLOPS_VERSION = "1.3.1";
+var SKILLOPS_VERSION = "1.3.3";
 var SKILL_NAME_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var SEMVER_REGEX = /^\d+\.\d+\.\d+$/;
 var FRONTMATTER_REGEX = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
@@ -5113,45 +5113,56 @@ function renderGlobalHelp(version, colorEnabled) {
   const c = colorEnabled;
   const bar = style.dim("\u2502", c);
   const banner = renderHeaderBanner(
-    "Framework & Library for AI Skills & Subagents",
+    "Skills & Agents Library for AI Coding IDEs",
     {
       version,
       colorEnabled: c
     }
   );
-  const formatCmdSection = (pillar) => {
-    const specs = COMMAND_HELP_SPECS.filter((s) => s.pillar === pillar);
-    return specs.map((s) => {
-      const aliasPart = s.aliases.length > 0 ? style.dim(` (${s.aliases.join(", ")})`, c) : "";
-      const cmdCol = padVisible(
-        `${style.bold(style.cyan(s.name, c), c)}${aliasPart}`,
-        23,
-        "left"
-      );
-      return `${bar}  ${cmdCol}${s.summary}`;
-    }).join("\n");
-  };
+  const coreCmds = [
+    {
+      cmd: "add [name...]",
+      desc: "Import Skills or Agents (interactive if no name given)"
+    },
+    {
+      cmd: "search <query>",
+      desc: "Search Skills & Agents by keyword, stack, or domain"
+    },
+    {
+      cmd: "list [query]",
+      desc: "List or filter available Skills & Agents in catalog"
+    },
+    {
+      cmd: "info <name>",
+      desc: "View details and how to use a Skill or Agent"
+    },
+    {
+      cmd: "remove <name>",
+      desc: "Remove an imported Skill or Agent from your project"
+    },
+    {
+      cmd: "init",
+      desc: "Auto-detect stack & IDE and import recommended bundle"
+    }
+  ];
+  const cmdRows = coreCmds.map(
+    (item) => `${bar}  ${padVisible(style.bold(style.cyan(item.cmd, c), c), 18, "left")}${item.desc}`
+  ).join("\n");
   return [
     banner,
-    `${bar}  Usage: npx skillops-cli <command> [options]`,
-    renderSectionHeader("Quickstart (Library + Framework)", c),
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.green("npx skillops-cli quickstart", c), c)}          ${style.dim("\u2014 Detect stack, sync Skills & MCP", c)}`,
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.cyan("npx skillops-cli info <name>", c), c)}         ${style.dim("\u2014 Inspect Skill/Subagent & usage", c)}`,
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.magenta("npx skillops-cli create skill <name>", c), c)} ${style.dim("\u2014 Scaffold a custom Skill", c)}`,
-    renderSectionHeader("1. Library of High-End Skills & Subagents", c),
-    formatCmdSection("library"),
-    renderSectionHeader(
-      "2. Framework for Building Custom Skills & Subagents",
-      c
-    ),
-    formatCmdSection("framework"),
-    renderSectionHeader(
-      "3. Universal Runtime Sync, Token Economy & Diagnostics",
-      c
-    ),
-    formatCmdSection("runtime"),
+    `${bar}  Usage: skillops <command> [options]`,
+    renderSectionHeader("Commands", c),
+    cmdRows,
+    renderSectionHeader("Options", c),
+    `${bar}  ${padVisible(style.cyan("-t, --target <ide>", c), 22, "left")}AI IDE (cursor, claude, copilot, windsurf, auto)`,
+    `${bar}  ${padVisible(style.cyan("-p, --project <dir>", c), 22, "left")}Project folder (default: current directory)`,
+    `${bar}  ${padVisible(style.cyan("--all", c), 22, "left")}Import all 10 Skills & 9 Agents`,
+    renderSectionHeader("Examples", c),
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops add", c)}                                  ${style.dim("\u2014 Interactive selector", c)}`,
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops add bug-reproducer-tdd red-team-breaker", c)} ${style.dim("\u2014 Direct import", c)}`,
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops list", c)}                                 ${style.dim("\u2014 Browse catalog", c)}`,
     bar,
-    `${style.dim("\u2570\u2500", c)} ${style.bold("Global Flags:", c)} ${style.cyan("-p <dir>", c)} \xB7 ${style.cyan("-t <harnesses>", c)} \xB7 ${style.cyan("-f <table|json|md>", c)} \xB7 ${style.cyan("-h <cmd>", c)}`
+    `${style.dim("\u2570\u2500", c)} ${style.dim("Run", c)} ${style.cyan("skillops <cmd> -h", c)} ${style.dim("for command options.", c)}`
   ].join("\n");
 }
 function renderCommandHelp(spec, version, colorEnabled) {
@@ -5176,6 +5187,341 @@ function renderCommandHelp(spec, version, colorEnabled) {
   return [headerLines, optionsSection, examplesSection].filter(Boolean).join("\n");
 }
 
+// src/ui/prompt.ts
+function optionMatchesTab(opt, tab) {
+  if (opt.kind === "agent") {
+    return tab === "agent";
+  }
+  return tab === "skill";
+}
+function optionMatchesQuery(opt, rawQuery) {
+  const q = rawQuery.trim().toLowerCase();
+  if (!q) {
+    return true;
+  }
+  return opt.label.toLowerCase().includes(q) || opt.value.toLowerCase().includes(q) || (opt.hint ?? "").toLowerCase().includes(q);
+}
+function getFilteredTabOptions(state, tab = state.activeTab) {
+  return state.options.filter(
+    (opt) => optionMatchesTab(opt, tab) && optionMatchesQuery(opt, state.searchQuery)
+  );
+}
+function createMultiSelectState(options) {
+  const initial = /* @__PURE__ */ new Set();
+  for (const opt of options) {
+    if (opt.initialSelected) {
+      initial.add(opt.value);
+    }
+  }
+  const hasSkills = options.some((opt) => optionMatchesTab(opt, "skill"));
+  return {
+    options,
+    activeTab: hasSkills ? "skill" : "agent",
+    cursor: 0,
+    selected: initial,
+    searchMode: false,
+    searchQuery: "",
+    status: "active"
+  };
+}
+function applyMultiSelectKey(state, key) {
+  if (state.status !== "active" || state.options.length === 0) {
+    return state;
+  }
+  if (key === "") {
+    return {
+      ...state,
+      status: "cancelled"
+    };
+  }
+  if (key === "\x1B") {
+    if (state.searchMode || state.searchQuery.length > 0) {
+      return {
+        ...state,
+        searchMode: false,
+        searchQuery: "",
+        cursor: 0
+      };
+    }
+    return {
+      ...state,
+      status: "cancelled"
+    };
+  }
+  if (key === "\r" || key === "\n") {
+    return {
+      ...state,
+      searchMode: false,
+      status: "submitted"
+    };
+  }
+  if (key === "\x1B[D" || key === "\x1BOD" || key === "\x1B[C" || key === "\x1BOC" || key === "	" || !state.searchMode && (key === "h" || key === "H" || key === "l" || key === "L")) {
+    const nextTab = state.activeTab === "skill" ? "agent" : "skill";
+    return {
+      ...state,
+      activeTab: nextTab,
+      cursor: 0
+    };
+  }
+  const visible = getFilteredTabOptions(state, state.activeTab);
+  const count = visible.length;
+  if (key === "\x1B[A" || key === "\x1BOA" || !state.searchMode && (key === "k" || key === "K")) {
+    if (count === 0) {
+      return state;
+    }
+    const nextCursor = (state.cursor - 1 + count) % count;
+    return {
+      ...state,
+      cursor: nextCursor
+    };
+  }
+  if (key === "\x1B[B" || key === "\x1BOB" || !state.searchMode && (key === "j" || key === "J")) {
+    if (count === 0) {
+      return state;
+    }
+    const nextCursor = (state.cursor + 1) % count;
+    return {
+      ...state,
+      cursor: nextCursor
+    };
+  }
+  if (key === " ") {
+    const currentOpt = visible[state.cursor];
+    if (!currentOpt) {
+      return state;
+    }
+    const nextSelected = new Set(state.selected);
+    if (nextSelected.has(currentOpt.value)) {
+      nextSelected.delete(currentOpt.value);
+    } else {
+      nextSelected.add(currentOpt.value);
+    }
+    return {
+      ...state,
+      selected: nextSelected
+    };
+  }
+  if (state.searchMode) {
+    if (key === "\x7F" || key === "\b") {
+      if (state.searchQuery.length === 0) {
+        return {
+          ...state,
+          searchMode: false,
+          cursor: 0
+        };
+      }
+      const nextQuery = state.searchQuery.slice(0, -1);
+      return {
+        ...state,
+        searchQuery: nextQuery,
+        cursor: 0
+      };
+    }
+    if (/^[a-zA-Z0-9_.-]$/.test(key)) {
+      const nextQuery = `${state.searchQuery}${key}`;
+      const nextState = {
+        ...state,
+        searchQuery: nextQuery,
+        cursor: 0
+      };
+      const currentMatches = getFilteredTabOptions(nextState, state.activeTab);
+      if (currentMatches.length === 0) {
+        const otherTab = state.activeTab === "skill" ? "agent" : "skill";
+        const otherMatches = getFilteredTabOptions(nextState, otherTab);
+        if (otherMatches.length > 0) {
+          return {
+            ...nextState,
+            activeTab: otherTab
+          };
+        }
+      }
+      return nextState;
+    }
+    return state;
+  }
+  if (key === "/") {
+    return {
+      ...state,
+      searchMode: true,
+      cursor: 0
+    };
+  }
+  if (key === "q" || key === "Q") {
+    return {
+      ...state,
+      status: "cancelled"
+    };
+  }
+  if (key === "a" || key === "A") {
+    if (visible.length === 0) {
+      return state;
+    }
+    const allTabSelected = visible.every(
+      (opt) => state.selected.has(opt.value)
+    );
+    const nextSelected = new Set(state.selected);
+    if (allTabSelected) {
+      for (const opt of visible) {
+        nextSelected.delete(opt.value);
+      }
+    } else {
+      for (const opt of visible) {
+        nextSelected.add(opt.value);
+      }
+    }
+    return {
+      ...state,
+      selected: nextSelected
+    };
+  }
+  return state;
+}
+function renderMultiSelectFrame(title, state, options = {}) {
+  const c = options.colorEnabled;
+  const bar = style.dim("\u2502", c);
+  const maxVisible = options.maxVisible ?? 10;
+  const totalSkills = state.options.filter(
+    (o) => optionMatchesTab(o, "skill")
+  ).length;
+  const totalAgents = state.options.filter(
+    (o) => optionMatchesTab(o, "agent")
+  ).length;
+  const filteredSkills = getFilteredTabOptions(state, "skill");
+  const filteredAgents = getFilteredTabOptions(state, "agent");
+  const visible = state.activeTab === "skill" ? filteredSkills : filteredAgents;
+  const total = visible.length;
+  const header = `${style.bold(style.cyan(`\u25C6 ${title}`, c), c)}`;
+  const instructions = state.searchMode ? `${bar}  ${style.dim("\u2191/\u2193 move \xB7 \u2190/\u2192 switch tab \xB7 Space select \xB7 Esc clear search \xB7 Enter import", c)}` : `${bar}  ${style.dim("\u2191/\u2193 move \xB7 \u2190/\u2192 switch tab \xB7 Space select \xB7 / search \xB7 a all \xB7 Enter import", c)}`;
+  const lines = [header];
+  if (options.subtitle) {
+    lines.push(`${bar}  ${options.subtitle}`);
+  }
+  lines.push(instructions, bar);
+  const hasQuery = state.searchQuery.length > 0;
+  const skillCountStr = hasQuery ? `${filteredSkills.length}/${totalSkills}` : `${totalSkills}`;
+  const agentCountStr = hasQuery ? `${filteredAgents.length}/${totalAgents}` : `${totalAgents}`;
+  const skillTabLabel = state.activeTab === "skill" ? style.bold(style.cyan(`[ \u25C6 Skills (${skillCountStr}) ]`, c), c) : style.dim(`\u25CB Skills (${skillCountStr})`, c);
+  const agentTabLabel = state.activeTab === "agent" ? style.bold(style.magenta(`[ \u25C6 Agents (${agentCountStr}) ]`, c), c) : style.dim(`\u25CB Agents (${agentCountStr})`, c);
+  const rawQuerySlice = state.searchQuery.length > 14 ? `\u2026${state.searchQuery.slice(-13)}` : state.searchQuery;
+  const searchSuffix = state.searchMode || hasQuery ? `   ${style.yellow(`/ Filter: ${rawQuerySlice}${state.searchMode ? "\u2588" : ""}`, c)}` : `   ${style.dim("(/ search)", c)}`;
+  lines.push(
+    `${style.dim("\u251C\u2500", c)} ${skillTabLabel}   ${agentTabLabel}${searchSuffix}`,
+    bar
+  );
+  if (total === 0) {
+    const tabName = state.activeTab === "skill" ? "Skills" : "Agents";
+    lines.push(
+      `${bar}  ${style.dim(`No ${tabName} match "${state.searchQuery}". Press Esc to clear filter.`, c)}`
+    );
+  } else {
+    let startIdx = 0;
+    if (total > maxVisible) {
+      const half = Math.floor(maxVisible / 2);
+      startIdx = Math.max(0, Math.min(state.cursor - half, total - maxVisible));
+    }
+    const endIdx = Math.min(total, startIdx + maxVisible);
+    if (startIdx > 0) {
+      lines.push(`${bar}  ${style.dim(`\u2191 ${startIdx} more above...`, c)}`);
+    }
+    const maxLabelCols = Math.min(
+      26,
+      visible.reduce((m, o) => Math.max(m, visibleLength(o.label)), 14)
+    );
+    for (let i = startIdx; i < endIdx; i++) {
+      const opt = visible[i];
+      if (!opt) continue;
+      const isCurrent = i === state.cursor;
+      const isChecked = state.selected.has(opt.value);
+      const pointer = isCurrent ? style.cyan("\u276F", c) : " ";
+      const checkbox = isChecked ? style.green("\u25C9", c) : style.dim("\u25EF", c);
+      const labelRaw = opt.label.length > maxLabelCols ? `${opt.label.slice(0, maxLabelCols - 1)}\u2026` : opt.label;
+      const labelPadded = padVisible(labelRaw, maxLabelCols + 1, "left");
+      const styledLabel = isCurrent ? style.bold(labelPadded, c) : isChecked ? style.green(labelPadded, c) : labelPadded;
+      const prefixWidth = 7 + maxLabelCols + 1;
+      const maxHintCols = Math.max(10, 76 - prefixWidth);
+      const rawHint = opt.hint ?? "";
+      const shortHint = rawHint.length > maxHintCols ? `${rawHint.slice(0, maxHintCols - 1)}\u2026` : rawHint;
+      const hintPart = shortHint ? ` ${style.dim(shortHint, c)}` : "";
+      lines.push(`${bar}  ${pointer} ${checkbox} ${styledLabel}${hintPart}`);
+    }
+    if (endIdx < total) {
+      lines.push(
+        `${bar}  ${style.dim(`\u2193 ${total - endIdx} more below...`, c)}`
+      );
+    }
+  }
+  lines.push(bar);
+  const selectedSkillsCount = state.options.filter(
+    (o) => optionMatchesTab(o, "skill") && state.selected.has(o.value)
+  ).length;
+  const selectedAgentsCount = state.options.filter(
+    (o) => optionMatchesTab(o, "agent") && state.selected.has(o.value)
+  ).length;
+  const summaryText = `${state.selected.size} selected (${selectedSkillsCount} Skills, ${selectedAgentsCount} Agents)`;
+  const rawTarget = options.targetHint ?? "";
+  const shortTarget = rawTarget.length > 18 ? `${rawTarget.slice(0, 17)}\u2026` : rawTarget;
+  const targetSuffix = shortTarget ? ` \xB7 IDE: ${shortTarget}` : "";
+  lines.push(
+    `${style.dim("\u2570\u2500", c)} ${style.bold(summaryText, c)}${style.dim(`${targetSuffix} \u2014 Enter to import`, c)}`
+  );
+  return lines.join("\n");
+}
+async function runMultiSelectPrompt(title, options, renderOpts = {}) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return null;
+  }
+  let state = createMultiSelectState(options);
+  let renderedLineCount = 0;
+  const render = () => {
+    const frame = renderMultiSelectFrame(title, state, renderOpts);
+    if (renderedLineCount > 0) {
+      process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+    }
+    process.stdout.write(`${frame}
+`);
+    renderedLineCount = frame.split("\n").length;
+  };
+  return new Promise((resolve) => {
+    const stdin = process.stdin;
+    const wasRaw = stdin.isRaw;
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf-8");
+    process.stdout.write("\x1B[?25l");
+    render();
+    const cleanup = () => {
+      stdin.removeListener("data", onData);
+      if (stdin.isTTY) {
+        stdin.setRawMode(Boolean(wasRaw));
+      }
+      stdin.pause();
+      process.stdout.write("\x1B[?25h");
+    };
+    const onData = (chunk) => {
+      const key = typeof chunk === "string" ? chunk : chunk.toString("utf-8");
+      state = applyMultiSelectKey(state, key);
+      if (state.status === "cancelled") {
+        if (renderedLineCount > 0) {
+          process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+        }
+        cleanup();
+        resolve(null);
+        return;
+      }
+      if (state.status === "submitted") {
+        if (renderedLineCount > 0) {
+          process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+        }
+        cleanup();
+        resolve([...state.selected]);
+        return;
+      }
+      render();
+    };
+    stdin.on("data", onData);
+  });
+}
+
 // src/framework/index.ts
 function extractMarkdownHeadings(markdownBody) {
   const headings = [];
@@ -5986,6 +6332,41 @@ function resolveCatalogDir(args, repoPath, loadedConfig) {
   }
   return path10.join(PACKAGE_ROOT, "catalog");
 }
+function buildInteractiveCatalogOptions(catalogDir) {
+  const options = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const skillDir of discoverSkillDirectories(catalogDir)) {
+    try {
+      const parsed = parseSkillDirectory(skillDir, { requireLayout: false });
+      if (!seen.has(parsed.manifest.name)) {
+        seen.add(parsed.manifest.name);
+        options.push({
+          value: parsed.manifest.name,
+          label: parsed.manifest.name,
+          kind: "skill",
+          hint: parsed.manifest.description
+        });
+      }
+    } catch {
+    }
+  }
+  for (const saPath of discoverSubagentFiles(catalogDir)) {
+    try {
+      const parsed = parseSubagentFile(saPath);
+      if (!seen.has(parsed.manifest.name)) {
+        seen.add(parsed.manifest.name);
+        options.push({
+          value: parsed.manifest.name,
+          label: parsed.manifest.name,
+          kind: "agent",
+          hint: parsed.manifest.description
+        });
+      }
+    } catch {
+    }
+  }
+  return options;
+}
 function runCli(argv) {
   const args = argv.slice(2);
   if (args.includes("--version") || args.includes("-V") || args[0] === "version") {
@@ -6184,6 +6565,7 @@ function runCli(argv) {
     return ExitCode.SUCCESS;
   }
   if (command === "list") {
+    const positionals = getPositionalArgs(args);
     const repoPath = getFlagValue(args, "--repo", "--project", "-p") ?? process.cwd();
     const cfgRes = loadSkillOpsConfig(repoPath);
     if (cfgRes.error) {
@@ -6195,6 +6577,12 @@ function runCli(argv) {
     }
     const catalogDir = resolveCatalogDir(args, repoPath, cfgRes.config);
     const rawFormat = getFlagValue(args, "--format", "-f") ?? "table";
+    if (positionals.length > 0) {
+      const format = rawFormat === "json" || rawFormat === "markdown" ? rawFormat : "table";
+      const report = searchCatalog(catalogDir, positionals.join(" "));
+      process.stdout.write(formatCatalogSearchReport(report, format));
+      return ExitCode.SUCCESS;
+    }
     const summary = auditCatalogTokenBudgets(catalogDir, {
       requireLayout: false
     });
@@ -6444,7 +6832,9 @@ function runCli(argv) {
     const force = args.includes("--force");
     const rawFormat = getFlagValue(args, "--format", "-f") ?? "table";
     const format = rawFormat === "json" || rawFormat === "markdown" ? rawFormat : "table";
-    if (positionals.length === 0) {
+    const importAll = args.includes("--all");
+    const itemsToAdd = importAll && positionals.length === 0 ? buildInteractiveCatalogOptions(catalogDir).map((o) => o.value) : positionals;
+    if (itemsToAdd.length === 0) {
       if (command === "add") {
         process.stderr.write(
           "Usage: npx skillops-cli add <skill-or-subagent-name> [more-names...] [options]\n"
@@ -6465,19 +6855,27 @@ function runCli(argv) {
       return report.passed ? ExitCode.SUCCESS : ExitCode.ERROR;
     }
     try {
-      let allPassed = true;
-      for (const itemName of positionals) {
-        const report = addSkillOrSubagent(repoPath, catalogDir, itemName, {
+      const reports = itemsToAdd.map(
+        (itemName) => addSkillOrSubagent(repoPath, catalogDir, itemName, {
           targets,
           dryRun,
           force
-        });
-        process.stdout.write(formatSyncReport(report, format));
-        if (!report.passed) {
-          allPassed = false;
-        }
+        })
+      );
+      const firstReport = reports[0];
+      if (!firstReport) {
+        return ExitCode.ERROR;
       }
-      return allPassed ? ExitCode.SUCCESS : ExitCode.ERROR;
+      const finalReport = reports.length === 1 ? firstReport : {
+        ...firstReport,
+        artifacts: reports.flatMap((r) => r.artifacts),
+        drift_conflicts: [
+          ...new Set(reports.flatMap((r) => r.drift_conflicts))
+        ],
+        passed: reports.every((r) => r.passed)
+      };
+      process.stdout.write(formatSyncReport(finalReport, format));
+      return finalReport.passed ? ExitCode.SUCCESS : ExitCode.ERROR;
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       process.stderr.write(`Error: ${msg}
@@ -6654,6 +7052,46 @@ function runCli(argv) {
   );
   return ExitCode.ERROR;
 }
+async function runCliInteractive(argv) {
+  const args = argv.slice(2);
+  const command = args[0];
+  if (command === "add" && !args.includes("--help") && !args.includes("-h") && !args.includes("--all") && getPositionalArgs(args).length === 0 && process.stdin.isTTY && process.stdout.isTTY) {
+    const repoPath = getFlagValue(args, "--repo", "--project", "-p") ?? process.cwd();
+    const cfgRes = loadSkillOpsConfig(repoPath);
+    if (cfgRes.error) {
+      process.stderr.write(
+        `Invalid .skillops.yml at ${cfgRes.configPath}: ${cfgRes.error}
+`
+      );
+      return ExitCode.BUDGET_OR_CONTRACT_ERROR;
+    }
+    const catalogDir = resolveCatalogDir(args, repoPath, cfgRes.config);
+    const targetsArg = resolveTargetsArg(args);
+    let targets;
+    try {
+      targets = targetsArg ? resolveRuntimeTargets(targetsArg, repoPath) : cfgRes.config?.targets ?? [...CORE_RUNTIME_TARGETS];
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`Invalid --targets: ${msg}
+`);
+      return ExitCode.BUDGET_OR_CONTRACT_ERROR;
+    }
+    const options = buildInteractiveCatalogOptions(catalogDir);
+    const selected = await runMultiSelectPrompt(
+      "SkillOps \u2014 Select Skills & Agents to Import",
+      options,
+      {
+        targetHint: targets.join(", ")
+      }
+    );
+    if (!selected || selected.length === 0) {
+      process.stdout.write("No Skills or Agents selected.\n");
+      return ExitCode.SUCCESS;
+    }
+    return runCli([...argv, ...selected]);
+  }
+  return runCli(argv);
+}
 function isDirectCliInvocation() {
   const entryArg = process.argv[1];
   if (!entryArg) {
@@ -6670,9 +7108,12 @@ function isDirectCliInvocation() {
   }
 }
 if (isDirectCliInvocation()) {
-  const code = runCli(process.argv);
-  process.exit(code);
+  runCliInteractive(process.argv).then((code) => {
+    process.exit(code);
+  });
 }
 export {
-  runCli
+  buildInteractiveCatalogOptions,
+  runCli,
+  runCliInteractive
 };