agdex 0.4.2 → 0.5.1

package/dist/cli/index.js

@@ -11,16 +11,21 @@ import {
   convexProvider,
   createProvider,
   deltaRsProvider,
+  discoverSkillsShRepo,
   embed,
   embedSkills,
+  fetchSkillsShSearch,
   ffmpegProvider,
   generateIndex,
+  generateSkillsIndex,
   getDefaultOutput,
   getDefaultSkillSources,
+  getEmbeddedProviders,
   getProvider,
   hasExistingIndex,
   hasExistingSkillsIndex,
   injectIndex,
+  injectSkillsIndex,
   isProviderAvailable,
   listProviders,
   manimProvider,
@@ -37,7 +42,7 @@ import {
   tailwindProvider,
   tauriProvider,
   tyProvider
-} from "../index-2hm5b6yq.js";
+} from "../index-thmt54kg.js";
 
 // node_modules/commander/lib/error.js
 var require_error = __commonJS((exports) => {
@@ -6883,7 +6888,147 @@ var {
 
 // src/cli/index.ts
 var import_prompts = __toESM(require_prompts3(), 1);
+var import_picocolors2 = __toESM(require_picocolors(), 1);
+
+// src/cli/configurable-select.ts
 var import_picocolors = __toESM(require_picocolors(), 1);
+async function configurableMultiselect(options) {
+  return new Promise((resolve) => {
+    const items = options.choices.map((c) => ({
+      title: c.title,
+      value: c.value,
+      selected: false,
+      version: c.defaultVersion,
+      description: "",
+      defaultVersion: c.defaultVersion
+    }));
+    let cursor = 0;
+    let state = "browsing";
+    let editBuffer = "";
+    let renderedLines = 0;
+    const stdin = process.stdin;
+    const stdout = process.stdout;
+    const wasRaw = stdin.isRaw;
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+    function cleanup() {
+      stdout.write("\x1B[?25h");
+      stdin.setRawMode(wasRaw ?? false);
+      stdin.removeAllListeners("data");
+      stdin.pause();
+    }
+    function render() {
+      if (renderedLines > 0) {
+        stdout.write(`\x1B[${renderedLines}A\x1B[0J`);
+      }
+      const lines = [];
+      lines.push(import_picocolors.default.cyan("? ") + import_picocolors.default.bold(options.message));
+      if (state === "browsing") {
+        lines.push(import_picocolors.default.gray("  Space: toggle · Tab: configure · Enter: confirm"));
+      } else {
+        lines.push(import_picocolors.default.gray("  Tab/Enter: next field · Esc: cancel"));
+      }
+      lines.push("");
+      for (let i = 0;i < items.length; i++) {
+        const item = items[i];
+        const isCursor = i === cursor;
+        const checkbox = item.selected ? import_picocolors.default.green("◉") : "○";
+        const arrow = isCursor ? import_picocolors.default.cyan("❯ ") : "  ";
+        const title = isCursor ? import_picocolors.default.cyan(item.title) : item.title;
+        let configInfo = "";
+        if (item.version) {
+          configInfo += import_picocolors.default.gray(` (v${item.version})`);
+        }
+        if (item.description) {
+          configInfo += import_picocolors.default.gray(` - ${item.description}`);
+        }
+        lines.push(`${arrow}${checkbox} ${title}${configInfo}`);
+        if (isCursor && state !== "browsing") {
+          const vActive = state === "editing-version";
+          const dActive = state === "editing-description";
+          const vLabel = vActive ? import_picocolors.default.cyan("  Version: ") : import_picocolors.default.gray("  Version: ");
+          const vValue = vActive ? editBuffer + import_picocolors.default.inverse(" ") : item.version || import_picocolors.default.gray("(auto-detect)");
+          lines.push(`     ${vLabel}${vValue}`);
+          const dLabel = dActive ? import_picocolors.default.cyan("  Description: ") : import_picocolors.default.gray("  Description: ");
+          const dValue = dActive ? editBuffer + import_picocolors.default.inverse(" ") : item.description || import_picocolors.default.gray("(optional)");
+          lines.push(`     ${dLabel}${dValue}`);
+        }
+      }
+      stdout.write("\x1B[?25l");
+      stdout.write(lines.join(`
+`) + `
+`);
+      renderedLines = lines.length;
+    }
+    function onData(key) {
+      if (key === "\x03") {
+        cleanup();
+        if (renderedLines > 0) {
+          stdout.write(`\x1B[${renderedLines}A\x1B[0J`);
+        }
+        process.exit(0);
+      }
+      if (state === "browsing") {
+        if (key === "\x1B[A" || key === "k") {
+          cursor = Math.max(0, cursor - 1);
+        } else if (key === "\x1B[B" || key === "j") {
+          cursor = Math.min(items.length - 1, cursor + 1);
+        } else if (key === " ") {
+          items[cursor].selected = !items[cursor].selected;
+        } else if (key === "\t") {
+          state = "editing-version";
+          editBuffer = items[cursor].version;
+          items[cursor].selected = true;
+        } else if (key === "\r") {
+          cleanup();
+          if (renderedLines > 0) {
+            stdout.write(`\x1B[${renderedLines}A\x1B[0J`);
+          }
+          const selected = items.filter((i) => i.selected);
+          stdout.write(import_picocolors.default.cyan("? ") + import_picocolors.default.bold(options.message) + " ");
+          if (selected.length === 0) {
+            stdout.write(import_picocolors.default.gray("(none selected)") + `
+`);
+          } else {
+            stdout.write(import_picocolors.default.green(selected.map((s) => s.title).join(", ")) + `
+`);
+          }
+          resolve(selected.map((i) => ({
+            value: i.value,
+            version: i.version,
+            description: i.description
+          })));
+          return;
+        }
+      } else if (state === "editing-version" || state === "editing-description") {
+        if (key === "\t" || key === "\r") {
+          if (state === "editing-version") {
+            items[cursor].version = editBuffer || items[cursor].defaultVersion;
+            state = "editing-description";
+            editBuffer = items[cursor].description;
+          } else {
+            items[cursor].description = editBuffer;
+            state = "browsing";
+          }
+        } else if (key === "\x1B" || key === "\x1B\x1B") {
+          if (state === "editing-version") {} else {}
+          state = "browsing";
+        } else if (key === "" || key === "\b") {
+          editBuffer = editBuffer.slice(0, -1);
+        } else if (key.length === 1 && key.charCodeAt(0) >= 32) {
+          editBuffer += key;
+        }
+      }
+      render();
+    }
+    stdin.on("data", onData);
+    render();
+  });
+}
+
+// src/cli/index.ts
+import os from "os";
 import fs from "fs";
 import path from "path";
 var program2 = new Command;
@@ -6897,7 +7042,7 @@ function formatSize(bytes) {
   return `${mb.toFixed(1)} MB`;
 }
 function onCancel() {
-  console.log(import_picocolors.default.yellow(`
+  console.log(import_picocolors2.default.yellow(`
 Cancelled.`));
   process.exit(0);
 }
@@ -6917,7 +7062,7 @@ async function runEmbed(options) {
     const preset = options.provider;
     const builtIn = getProvider(preset);
     if (!builtIn) {
-      console.error(import_picocolors.default.red(`Unknown provider: ${options.provider}. Available: ${listProviders().join(", ")}`));
+      console.error(import_picocolors2.default.red(`Unknown provider: ${options.provider}. Available: ${listProviders().join(", ")}`));
       process.exit(1);
     }
     provider = builtIn;
@@ -6931,7 +7076,8 @@ async function runEmbed(options) {
       provider = result.provider;
       version = result.version;
       output = result.output;
-      await executeEmbed(cwd, provider, version, output, options.global, result.description);
+      const useGlobal = options.local ? false : undefined;
+      await executeEmbed(cwd, provider, version, output, useGlobal, result.description);
       return;
     }
   } else {
@@ -6939,29 +7085,38 @@ async function runEmbed(options) {
     provider = result.provider;
     version = result.version;
     output = result.output;
-    await executeEmbed(cwd, provider, version, output, options.global, result.description);
+    const useGlobal = options.local ? false : undefined;
+    await executeEmbed(cwd, provider, version, output, useGlobal, result.description);
     return;
   }
   output = options.output || getDefaultOutput();
   if (!version && !provider.detectVersion) {
-    console.error(import_picocolors.default.red(`Provider ${provider.displayName} requires --version flag since auto-detection is not supported.`));
+    console.error(import_picocolors2.default.red(`Provider ${provider.displayName} requires --version flag since auto-detection is not supported.`));
     process.exit(1);
   }
-  await executeEmbed(cwd, provider, version, output, options.global, options.description);
+  const useGlobalCache = options.local ? false : undefined;
+  await executeEmbed(cwd, provider, version, output, useGlobalCache, options.description);
 }
 async function executeEmbed(cwd, provider, version, output, globalCache, description) {
   let resolvedVersion = version;
+  let usingDefaultBranch = false;
   if (!resolvedVersion && provider.detectVersion) {
     const detected = provider.detectVersion(cwd);
     if (!detected.version) {
-      console.error(import_picocolors.default.red(detected.error || `Could not detect ${provider.displayName} version`));
-      process.exit(1);
+      const fallbackBranch = provider.defaultBranch || "main";
+      console.log(import_picocolors2.default.yellow(`
+⚠ ${detected.error || `Could not detect ${provider.displayName} version`}`));
+      console.log(import_picocolors2.default.yellow(`  Using latest documentation from '${fallbackBranch}' branch.
+`));
+      resolvedVersion = fallbackBranch;
+      usingDefaultBranch = true;
+    } else {
+      resolvedVersion = detected.version;
     }
-    resolvedVersion = detected.version;
   }
-  const displayPath = globalCache ? `~/.cache/agdex/${provider.name}` : `.agdex/${provider.name}`;
+  const versionLabel = usingDefaultBranch ? "latest" : resolvedVersion;
   console.log(`
-Downloading ${import_picocolors.default.cyan(provider.displayName)} ${import_picocolors.default.cyan(resolvedVersion)} documentation to ${import_picocolors.default.cyan(displayPath)}...`);
+Embedding ${import_picocolors2.default.cyan(provider.displayName)} ${import_picocolors2.default.cyan(versionLabel)} documentation...`);
   const result = await embed({
     cwd,
     provider,
@@ -6971,14 +7126,19 @@ Downloading ${import_picocolors.default.cyan(provider.displayName)} ${import_pic
     description
   });
   if (!result.success) {
-    console.error(import_picocolors.default.red(`Failed: ${result.error}`));
+    console.error(import_picocolors2.default.red(`Failed: ${result.error}`));
     process.exit(1);
   }
+  if (result.cacheHit) {
+    console.log(`${import_picocolors2.default.green("✓")} Using cached docs from ${import_picocolors2.default.bold(result.docsPath)}`);
+  } else {
+    console.log(`${import_picocolors2.default.green("✓")} Downloaded docs to ${import_picocolors2.default.bold(result.docsPath)}`);
+  }
   const action = result.isNewFile ? "Created" : "Updated";
   const sizeInfo = result.isNewFile ? formatSize(result.sizeAfter) : `${formatSize(result.sizeBefore)} → ${formatSize(result.sizeAfter)}`;
-  console.log(`${import_picocolors.default.green("✓")} ${action} ${import_picocolors.default.bold(result.targetFile)} (${sizeInfo})`);
+  console.log(`${import_picocolors2.default.green("✓")} ${action} ${import_picocolors2.default.bold(result.targetFile)} (${sizeInfo})`);
   if (result.gitignoreUpdated) {
-    console.log(`${import_picocolors.default.green("✓")} Added ${import_picocolors.default.bold(".agdex")} to .gitignore`);
+    console.log(`${import_picocolors2.default.green("✓")} Added ${import_picocolors2.default.bold(".agdex")} to .gitignore`);
   }
   console.log("");
 }
@@ -7061,14 +7221,14 @@ async function detectRepoContent(repo, branch) {
 }
 async function promptForOptions(cwd) {
   const detected = autoDetectProvider(cwd);
-  console.log(import_picocolors.default.cyan(`
+  console.log(import_picocolors2.default.cyan(`
 agdex - Documentation Index for AI Coding Agents
 `));
-  console.log(import_picocolors.default.gray("  Create compressed documentation indexes for AI coding assistants."));
-  console.log(import_picocolors.default.gray(`  Indexes are embedded into AGENTS.md/CLAUDE.md files.
+  console.log(import_picocolors2.default.gray("  Create compressed documentation indexes for AI coding assistants."));
+  console.log(import_picocolors2.default.gray(`  Indexes are embedded into AGENTS.md/CLAUDE.md files.
 `));
   if (detected) {
-    console.log(import_picocolors.default.green(`  ✓ Detected ${detected.provider.displayName} v${detected.version}
+    console.log(import_picocolors2.default.green(`  ✓ Detected ${detected.provider.displayName} v${detected.version}
 `));
   }
   const actionResponse = await import_prompts.default({
@@ -7106,12 +7266,12 @@ agdex - Documentation Index for AI Coding Agents
   }, { onCancel });
   if (actionResponse.action === "detected" && detected) {
     const output2 = await promptForOutputFile();
-    const description2 = await promptForDescription();
+    const description = await promptForDescription();
     return {
       provider: detected.provider,
       version: detected.version,
       output: output2,
-      description: description2
+      description
     };
   }
   if (actionResponse.action === "local") {
@@ -7147,41 +7307,37 @@ agdex - Documentation Index for AI Coding Agents
     return await promptForGitHubRepo(cwd);
   }
   const availableProviders = listProviders().filter(isProviderAvailable);
-  const response = await import_prompts.default([
-    {
-      type: "select",
-      name: "provider",
-      message: "Documentation provider",
-      choices: availableProviders.map((p) => ({
-        title: getProvider(p).displayName,
-        value: p
-      })),
-      initial: detected ? availableProviders.indexOf(detected.provider.name) : 0
-    }
-  ], { onCancel });
-  const provider = getProvider(response.provider);
-  let initialVersion = "";
-  if (provider.detectVersion) {
-    const detectedVersion = provider.detectVersion(cwd);
-    if (detectedVersion.version) {
-      initialVersion = detectedVersion.version;
+  const choices = availableProviders.map((p) => {
+    const provider = getProvider(p);
+    let defaultVersion = "";
+    if (provider.detectVersion) {
+      const detected2 = provider.detectVersion(cwd);
+      if (detected2.version) {
+        defaultVersion = detected2.version;
+      }
     }
+    return {
+      title: provider.displayName,
+      value: p,
+      defaultVersion
+    };
+  });
+  const selected = await configurableMultiselect({
+    message: "Select documentation providers",
+    choices
+  });
+  if (!selected || selected.length === 0) {
+    console.log(import_picocolors2.default.yellow(`
+No providers selected.
+`));
+    process.exit(0);
   }
-  const versionResponse = await import_prompts.default({
-    type: "text",
-    name: "version",
-    message: `${provider.displayName} version`,
-    initial: initialVersion,
-    validate: (v) => v.trim() ? true : "Please enter a version"
-  }, { onCancel });
   const output = await promptForOutputFile();
-  const description = await promptForDescription();
-  return {
-    provider,
-    version: versionResponse.version,
-    output,
-    description
-  };
+  for (const item of selected) {
+    const provider = getProvider(item.value);
+    await executeEmbed(cwd, provider, item.version, output, undefined, item.description || undefined);
+  }
+  process.exit(0);
 }
 async function promptForOutputFile() {
   const defaultOutput = getDefaultOutput();
@@ -7222,10 +7378,10 @@ async function promptForDescription() {
 }
 async function promptForGitHubRepo(cwd) {
   console.log("");
-  console.log(import_picocolors.default.gray("  Enter a GitHub URL or owner/repo. Examples:"));
-  console.log(import_picocolors.default.gray("    • anthropics/skills"));
-  console.log(import_picocolors.default.gray("    • https://github.com/vercel/next.js"));
-  console.log(import_picocolors.default.gray("    • https://github.com/anthropics/skills/tree/main/skills"));
+  console.log(import_picocolors2.default.gray("  Enter a GitHub URL or owner/repo. Examples:"));
+  console.log(import_picocolors2.default.gray("    • anthropics/skills"));
+  console.log(import_picocolors2.default.gray("    • https://github.com/vercel/next.js"));
+  console.log(import_picocolors2.default.gray("    • https://github.com/anthropics/skills/tree/main/skills"));
   console.log("");
   const urlResponse = await import_prompts.default({
     type: "text",
@@ -7242,10 +7398,10 @@ async function promptForGitHubRepo(cwd) {
   }, { onCancel });
   const parsed = parseGitHubInput(urlResponse.url);
   console.log(`
-${import_picocolors.default.gray("Checking repository contents...")}`);
+${import_picocolors2.default.gray("Checking repository contents...")}`);
   const repoContent = await detectRepoContent(parsed.repo, parsed.branch);
   if (parsed.path) {
-    console.log(import_picocolors.default.green(`  ✓ Using specified path: ${parsed.path}
+    console.log(import_picocolors2.default.green(`  ✓ Using specified path: ${parsed.path}
 `));
     const nameResponse2 = await import_prompts.default({
       type: "text",
@@ -7277,10 +7433,10 @@ ${import_picocolors.default.gray("Checking repository contents...")}`);
   if (repoContent.hasSkills)
     detected.push(`skills (${repoContent.skillsPath})`);
   if (detected.length > 0) {
-    console.log(import_picocolors.default.green(`  ✓ Found: ${detected.join(", ")}
+    console.log(import_picocolors2.default.green(`  ✓ Found: ${detected.join(", ")}
 `));
   } else {
-    console.log(import_picocolors.default.yellow(`  No standard docs/skills directories detected.
+    console.log(import_picocolors2.default.yellow(`  No standard docs/skills directories detected.
 `));
   }
   const choices = [];
@@ -7325,10 +7481,8 @@ ${import_picocolors.default.gray("Checking repository contents...")}`);
     docsPath = ".";
     displayName = `${parsed.repo.split("/")[1]} README`;
   } else if (contentChoice.content === "skills") {
-    console.log(import_picocolors.default.yellow(`
-Skills indexing from GitHub URLs is coming soon!`));
-    console.log(import_picocolors.default.gray(`For now, clone the repo and use: agdex skills local <path>
-`));
+    const output2 = await promptForOutputFile();
+    await runSkillsEmbed({ repo: parsed.repo, output: output2 });
     process.exit(0);
   } else {
     const pathResponse = await import_prompts.default({
@@ -7365,14 +7519,14 @@ async function runLocal(docsPath, options) {
   const cwd = process.cwd();
   const absoluteDocsPath = path.isAbsolute(docsPath) ? docsPath : path.join(cwd, docsPath);
   if (!fs.existsSync(absoluteDocsPath)) {
-    console.error(import_picocolors.default.red(`Documentation directory not found: ${docsPath}`));
+    console.error(import_picocolors2.default.red(`Documentation directory not found: ${docsPath}`));
     process.exit(1);
   }
   const name = options.name || path.basename(docsPath);
   const output = options.output || getDefaultOutput();
   const extensions = options.extensions?.split(",") || [".md", ".mdx"];
   console.log(`
-Building index from ${import_picocolors.default.cyan(docsPath)}...`);
+Building index from ${import_picocolors2.default.cyan(docsPath)}...`);
   const targetPath = path.join(cwd, output);
   let existingContent = "";
   let sizeBefore = 0;
@@ -7398,38 +7552,40 @@ Building index from ${import_picocolors.default.cyan(docsPath)}...`);
   const sizeAfter = Buffer.byteLength(newContent, "utf-8");
   const action = isNewFile ? "Created" : "Updated";
   const sizeInfo = isNewFile ? formatSize(sizeAfter) : `${formatSize(sizeBefore)} → ${formatSize(sizeAfter)}`;
-  console.log(`${import_picocolors.default.green("✓")} ${action} ${import_picocolors.default.bold(output)} (${sizeInfo})`);
+  console.log(`${import_picocolors2.default.green("✓")} ${action} ${import_picocolors2.default.bold(output)} (${sizeInfo})`);
   console.log("");
 }
 function runList() {
-  console.log(import_picocolors.default.cyan(`
+  console.log(import_picocolors2.default.cyan(`
 \uD83D\uDCDA Built-in Documentation Providers
 `));
   for (const preset of listProviders()) {
     const provider = getProvider(preset);
-    const status = provider ? import_picocolors.default.green("✓") : import_picocolors.default.gray("○");
+    const status = provider ? import_picocolors2.default.green("✓") : import_picocolors2.default.gray("○");
     const name = provider?.displayName || preset;
     const repo = provider?.repo || "not implemented";
-    console.log(`  ${status} ${import_picocolors.default.bold(preset)} - ${name} (${import_picocolors.default.gray(repo)})`);
+    console.log(`  ${status} ${import_picocolors2.default.bold(preset)} - ${name} (${import_picocolors2.default.gray(repo)})`);
   }
   console.log("");
-  console.log(import_picocolors.default.cyan(`\uD83D\uDCE6 Usage Examples
+  console.log(import_picocolors2.default.cyan(`\uD83D\uDCE6 Usage Examples
 `));
-  console.log(import_picocolors.default.gray("  Built-in provider:"));
-  console.log(`    ${import_picocolors.default.white("agdex --provider nextjs")}`);
+  console.log(import_picocolors2.default.gray("  Built-in provider:"));
+  console.log(`    ${import_picocolors2.default.white("agdex --provider nextjs")}`);
   console.log("");
-  console.log(import_picocolors.default.gray("  Any GitHub repository:"));
-  console.log(`    ${import_picocolors.default.white("agdex --repo owner/repo --docs-path docs")}`);
+  console.log(import_picocolors2.default.gray("  Any GitHub repository:"));
+  console.log(`    ${import_picocolors2.default.white("agdex --repo owner/repo --docs-path docs")}`);
   console.log("");
-  console.log(import_picocolors.default.gray("  GitHub URL with path:"));
-  console.log(`    ${import_picocolors.default.white("agdex")} ${import_picocolors.default.gray("(interactive)")}`);
-  console.log(`    ${import_picocolors.default.gray("→ then enter:")} ${import_picocolors.default.white("https://github.com/anthropics/skills/tree/main/skills")}`);
+  console.log(import_picocolors2.default.gray("  GitHub URL with path:"));
+  console.log(`    ${import_picocolors2.default.white("agdex")} ${import_picocolors2.default.gray("(interactive)")}`);
+  console.log(`    ${import_picocolors2.default.gray("→ then enter:")} ${import_picocolors2.default.white("https://github.com/anthropics/skills/tree/main/skills")}`);
   console.log("");
-  console.log(import_picocolors.default.gray("  Local documentation:"));
-  console.log(`    ${import_picocolors.default.white('agdex local ./my-docs --name "My Docs"')}`);
+  console.log(import_picocolors2.default.gray("  Local documentation:"));
+  console.log(`    ${import_picocolors2.default.white('agdex local ./my-docs --name "My Docs"')}`);
   console.log("");
-  console.log(import_picocolors.default.gray("  Skills indexing:"));
-  console.log(`    ${import_picocolors.default.white("agdex skills embed")}`);
+  console.log(import_picocolors2.default.gray("  Skills indexing:"));
+  console.log(`    ${import_picocolors2.default.white("agdex skills embed")}`);
+  console.log(`    ${import_picocolors2.default.white("agdex skills embed --repo vercel-labs/agent-skills")}`);
+  console.log(`    ${import_picocolors2.default.white("agdex skills find react")}`);
   console.log("");
 }
 program2.name("agdex").description(`Create compressed documentation indexes for AI coding agents.
@@ -7441,19 +7597,76 @@ Sources you can index:
   • Claude Code skills
 
 Run 'agdex' without arguments for interactive mode.`).version("0.4.2");
-program2.command("embed", { isDefault: true }).description("Embed documentation index into AGENTS.md/CLAUDE.md").option("-p, --provider <name>", "Documentation provider (nextjs, react, etc.)").option("--fw-version <version>", "Framework version (auto-detected if not provided)").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("--repo <owner/repo>", "Custom GitHub repository").option("--docs-path <path>", "Path to docs folder in repository").option("-g, --global", "Store docs in global cache (~/.cache/agdex/) instead of local .agdex/").option("-d, --description <text>", "Additional description to include in the index").action(runEmbed);
+program2.command("embed", { isDefault: true }).description("Embed documentation index into AGENTS.md/CLAUDE.md").option("-p, --provider <name>", "Documentation provider (nextjs, react, etc.)").option("--fw-version <version>", "Framework version (auto-detected if not provided)").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("--repo <owner/repo>", "Custom GitHub repository").option("--docs-path <path>", "Path to docs folder in repository").option("-g, --global", "Store docs in global cache (~/.cache/agdex/) (default)").option("-l, --local", "Store docs in local .agdex/ instead of global cache").option("-d, --description <text>", "Additional description to include in the index").action(runEmbed);
 program2.command("local <docs-path>").description("Build index from local documentation directory").option("-n, --name <name>", "Display name for the documentation").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("-e, --extensions <exts>", "File extensions to include (comma-separated, default: .md,.mdx)").action(runLocal);
 program2.command("list").description("List available documentation providers").action(runList);
-function runRemove(options) {
+async function runRemove(options) {
   const cwd = process.cwd();
   const output = options.output || getDefaultOutput();
   const targetPath = path.join(cwd, output);
   if (!fs.existsSync(targetPath)) {
-    console.error(import_picocolors.default.red(`File not found: ${output}`));
+    console.error(import_picocolors2.default.red(`File not found: ${output}`));
     process.exit(1);
   }
   let content = fs.readFileSync(targetPath, "utf-8");
   const sizeBefore = Buffer.byteLength(content, "utf-8");
+  const hasExplicitFlags = options.docs || options.skills || options.provider;
+  if (!hasExplicitFlags) {
+    const embeddedProviders = getEmbeddedProviders(content);
+    const hasSkills = hasExistingSkillsIndex(content);
+    if (embeddedProviders.length === 0 && !hasSkills) {
+      console.log(import_picocolors2.default.yellow(`
+No indices found to remove.
+`));
+      return;
+    }
+    const choices = [];
+    for (const provider of embeddedProviders) {
+      choices.push({ title: `docs: ${provider}`, value: `docs:${provider}` });
+    }
+    if (hasSkills) {
+      choices.push({ title: "skills", value: "skills" });
+    }
+    const response = await import_prompts.default({
+      type: "multiselect",
+      name: "indices",
+      message: "Select indices to remove",
+      choices,
+      instructions: false,
+      hint: "- Space to select, Return to confirm"
+    });
+    if (!response.indices || response.indices.length === 0) {
+      console.log(import_picocolors2.default.yellow(`
+No indices selected.
+`));
+      return;
+    }
+    const selected = response.indices;
+    let docsRemoved2 = [];
+    let skillsRemoved2 = false;
+    for (const item of selected) {
+      if (item === "skills") {
+        content = removeSkillsIndex(content);
+        skillsRemoved2 = true;
+      } else if (item.startsWith("docs:")) {
+        const provider = item.slice(5);
+        content = removeDocsIndex(content, provider);
+        docsRemoved2.push(provider);
+      }
+    }
+    fs.writeFileSync(targetPath, content, "utf-8");
+    const sizeAfter2 = Buffer.byteLength(content, "utf-8");
+    console.log("");
+    for (const provider of docsRemoved2) {
+      console.log(`${import_picocolors2.default.green("✓")} Removed docs index (${provider}) from ${import_picocolors2.default.bold(output)}`);
+    }
+    if (skillsRemoved2) {
+      console.log(`${import_picocolors2.default.green("✓")} Removed skills index from ${import_picocolors2.default.bold(output)}`);
+    }
+    console.log(import_picocolors2.default.gray(`  (${formatSize(sizeBefore)} → ${formatSize(sizeAfter2)})`));
+    console.log("");
+    return;
+  }
   const removeAll = !options.docs && !options.skills;
   const removeDocs = removeAll || options.docs;
   const removeSkillsIdx = removeAll || options.skills;
@@ -7468,7 +7681,7 @@ function runRemove(options) {
     skillsRemoved = true;
   }
   if (!docsRemoved && !skillsRemoved) {
-    console.log(import_picocolors.default.yellow(`
+    console.log(import_picocolors2.default.yellow(`
 No indices found to remove.
 `));
     return;
@@ -7478,12 +7691,12 @@ No indices found to remove.
   console.log("");
   if (docsRemoved) {
     const providerInfo = options.provider ? ` (${options.provider})` : " (all providers)";
-    console.log(`${import_picocolors.default.green("✓")} Removed docs index${providerInfo} from ${import_picocolors.default.bold(output)}`);
+    console.log(`${import_picocolors2.default.green("✓")} Removed docs index${providerInfo} from ${import_picocolors2.default.bold(output)}`);
   }
   if (skillsRemoved) {
-    console.log(`${import_picocolors.default.green("✓")} Removed skills index from ${import_picocolors.default.bold(output)}`);
+    console.log(`${import_picocolors2.default.green("✓")} Removed skills index from ${import_picocolors2.default.bold(output)}`);
   }
-  console.log(import_picocolors.default.gray(`  (${formatSize(sizeBefore)} → ${formatSize(sizeAfter)})`));
+  console.log(import_picocolors2.default.gray(`  (${formatSize(sizeBefore)} → ${formatSize(sizeAfter)})`));
   console.log("");
 }
 program2.command("remove").description("Remove embedded indices from AGENTS.md/CLAUDE.md").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("--docs", "Remove only docs index").option("--skills", "Remove only skills index").option("-p, --provider <name>", "Remove only a specific provider's docs index").action(runRemove);
@@ -7497,21 +7710,77 @@ async function runSkillsEmbed(options) {
     includeEnabledPlugins: options.plugins !== false,
     pluginPaths: options.plugin || []
   });
+  if (options.repo) {
+    const { execSync } = await import("child_process");
+    const repoName = options.repo;
+    console.log(`
+Fetching skills from ${import_picocolors2.default.cyan(repoName)}...`);
+    const cacheDir = path.join(os.homedir(), ".cache", "agdex", "skills-sh", repoName.replace("/", path.sep));
+    const cacheHit = fs.existsSync(cacheDir) && fs.readdirSync(cacheDir).length > 0;
+    if (!cacheHit) {
+      const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "agdex-skills-"));
+      try {
+        execSync(`git clone --depth 1 --filter=blob:none https://github.com/${repoName}.git .`, { cwd: tempDir, stdio: "pipe" });
+        fs.mkdirSync(cacheDir, { recursive: true });
+        fs.cpSync(tempDir, cacheDir, { recursive: true });
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.error(import_picocolors2.default.red(`Failed to clone ${repoName}: ${msg}`));
+        process.exit(1);
+      } finally {
+        if (fs.existsSync(tempDir)) {
+          fs.rmSync(tempDir, { recursive: true });
+        }
+      }
+      console.log(`${import_picocolors2.default.green("✓")} Cloned ${import_picocolors2.default.bold(repoName)}`);
+    } else {
+      console.log(`${import_picocolors2.default.green("✓")} Using cached ${import_picocolors2.default.bold(repoName)}`);
+    }
+    const remoteSkills = discoverSkillsShRepo(cacheDir, repoName);
+    if (remoteSkills.length === 0) {
+      console.error(import_picocolors2.default.red(`No skills found in ${repoName}`));
+      process.exit(1);
+    }
+    console.log(`${import_picocolors2.default.green("✓")} Found ${import_picocolors2.default.bold(remoteSkills.length.toString())} skills`);
+    const localSkills = collectAllSkills(sources);
+    const allSkills = [...remoteSkills, ...localSkills];
+    const targetPath = path.join(cwd, output);
+    let existingContent = "";
+    let sizeBefore = 0;
+    let isNewFile = true;
+    if (fs.existsSync(targetPath)) {
+      existingContent = fs.readFileSync(targetPath, "utf-8");
+      sizeBefore = Buffer.byteLength(existingContent, "utf-8");
+      isNewFile = false;
+    }
+    const indexContent = generateSkillsIndex(allSkills, {
+      regenerateCommand: `npx agdex skills embed --repo ${repoName}`
+    });
+    const newContent = injectSkillsIndex(existingContent, indexContent);
+    fs.writeFileSync(targetPath, newContent, "utf-8");
+    const sizeAfter = Buffer.byteLength(newContent, "utf-8");
+    const action2 = isNewFile ? "Created" : "Updated";
+    const sizeInfo2 = isNewFile ? formatSize(sizeAfter) : `${formatSize(sizeBefore)} → ${formatSize(sizeAfter)}`;
+    console.log(`${import_picocolors2.default.green("✓")} ${action2} ${import_picocolors2.default.bold(output)} (${sizeInfo2})`);
+    console.log(`${import_picocolors2.default.green("✓")} Indexed ${import_picocolors2.default.bold(allSkills.length.toString())} skills`);
+    console.log("");
+    return;
+  }
   if (sources.length === 0) {
-    console.error(import_picocolors.default.red("No skill sources configured. Use --plugin, --user, --project, or --plugins flags."));
+    console.error(import_picocolors2.default.red("No skill sources configured. Use --plugin, --user, --project, or --plugins flags."));
     process.exit(1);
   }
   console.log(`
-Discovering skills from ${import_picocolors.default.cyan(sources.length.toString())} sources...`);
+Discovering skills from ${import_picocolors2.default.cyan(sources.length.toString())} sources...`);
   const result = await embedSkills({ cwd, sources, output });
   if (!result.success) {
-    console.error(import_picocolors.default.red(`Failed: ${result.error}`));
+    console.error(import_picocolors2.default.red(`Failed: ${result.error}`));
     process.exit(1);
   }
   const action = result.isNewFile ? "Created" : "Updated";
   const sizeInfo = result.isNewFile ? formatSize(result.sizeAfter) : `${formatSize(result.sizeBefore)} → ${formatSize(result.sizeAfter)}`;
-  console.log(`${import_picocolors.default.green("✓")} ${action} ${import_picocolors.default.bold(result.targetFile)} (${sizeInfo})`);
-  console.log(`${import_picocolors.default.green("✓")} Indexed ${import_picocolors.default.bold(result.skillCount.toString())} skills`);
+  console.log(`${import_picocolors2.default.green("✓")} ${action} ${import_picocolors2.default.bold(result.targetFile)} (${sizeInfo})`);
+  console.log(`${import_picocolors2.default.green("✓")} Indexed ${import_picocolors2.default.bold(result.skillCount.toString())} skills`);
   if (result.sourceBreakdown) {
     const breakdown = [];
     if (result.sourceBreakdown.plugin > 0) {
@@ -7523,7 +7792,7 @@ Discovering skills from ${import_picocolors.default.cyan(sources.length.toString
     if (result.sourceBreakdown.project > 0) {
       breakdown.push(`${result.sourceBreakdown.project} project`);
     }
-    console.log(import_picocolors.default.gray(`  (${breakdown.join(", ")})`));
+    console.log(import_picocolors2.default.gray(`  (${breakdown.join(", ")})`));
   }
   console.log("");
 }
@@ -7537,12 +7806,12 @@ function runSkillsList(options) {
   });
   const skills = collectAllSkills(sources);
   if (skills.length === 0) {
-    console.log(import_picocolors.default.yellow(`
+    console.log(import_picocolors2.default.yellow(`
 No skills found in any of the specified sources.
 `));
     return;
   }
-  console.log(import_picocolors.default.cyan(`
+  console.log(import_picocolors2.default.cyan(`
 Discovered ${skills.length} skills:
 `));
   const grouped = new Map;
@@ -7553,11 +7822,11 @@ Discovered ${skills.length} skills:
     grouped.set(key, existing);
   }
   for (const [source, sourceSkills] of grouped) {
-    console.log(import_picocolors.default.bold(`  ${source}:`));
+    console.log(import_picocolors2.default.bold(`  ${source}:`));
     for (const skill of sourceSkills) {
-      console.log(`    ${import_picocolors.default.green("•")} ${import_picocolors.default.bold(skill.name)} - ${skill.description}`);
+      console.log(`    ${import_picocolors2.default.green("•")} ${import_picocolors2.default.bold(skill.name)} - ${skill.description}`);
       if (skill.siblingFiles.length > 0) {
-        console.log(import_picocolors.default.gray(`      Files: ${skill.siblingFiles.join(", ")}`));
+        console.log(import_picocolors2.default.gray(`      Files: ${skill.siblingFiles.join(", ")}`));
       }
     }
     console.log("");
@@ -7567,7 +7836,7 @@ async function runSkillsLocal(skillsPath, options) {
   const cwd = process.cwd();
   const absolutePath = path.isAbsolute(skillsPath) ? skillsPath : path.join(cwd, skillsPath);
   if (!fs.existsSync(absolutePath)) {
-    console.error(import_picocolors.default.red(`Skills directory not found: ${skillsPath}`));
+    console.error(import_picocolors2.default.red(`Skills directory not found: ${skillsPath}`));
     process.exit(1);
   }
   const output = options.output || getDefaultOutput();
@@ -7579,19 +7848,96 @@ async function runSkillsLocal(skillsPath, options) {
     label
   }];
   console.log(`
-Discovering skills from ${import_picocolors.default.cyan(skillsPath)}...`);
+Discovering skills from ${import_picocolors2.default.cyan(skillsPath)}...`);
   const result = await embedSkills({ cwd, sources, output });
   if (!result.success) {
-    console.error(import_picocolors.default.red(`Failed: ${result.error}`));
+    console.error(import_picocolors2.default.red(`Failed: ${result.error}`));
     process.exit(1);
   }
   const action = result.isNewFile ? "Created" : "Updated";
   const sizeInfo = result.isNewFile ? formatSize(result.sizeAfter) : `${formatSize(result.sizeBefore)} → ${formatSize(result.sizeAfter)}`;
-  console.log(`${import_picocolors.default.green("✓")} ${action} ${import_picocolors.default.bold(result.targetFile)} (${sizeInfo})`);
-  console.log(`${import_picocolors.default.green("✓")} Indexed ${import_picocolors.default.bold(result.skillCount.toString())} skills`);
+  console.log(`${import_picocolors2.default.green("✓")} ${action} ${import_picocolors2.default.bold(result.targetFile)} (${sizeInfo})`);
+  console.log(`${import_picocolors2.default.green("✓")} Indexed ${import_picocolors2.default.bold(result.skillCount.toString())} skills`);
   console.log("");
 }
-skillsCommand.command("embed").description("Embed skills index into AGENTS.md").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("--plugin <path...>", "Additional plugin repo paths (with plugins/ structure)").option("--plugins", "Include enabled plugins from settings.json (default: true)").option("--no-plugins", "Exclude enabled plugins from settings.json").option("--user", "Include ~/.claude/skills (default: true)").option("--no-user", "Exclude ~/.claude/skills").option("--project", "Include .claude/skills (default: true)").option("--no-project", "Exclude .claude/skills").action(runSkillsEmbed);
+async function runSkillsFind(query, options) {
+  const limit = options.limit || 20;
+  if (query) {
+    console.log(`
+Searching skills.sh for ${import_picocolors2.default.cyan(query)}...`);
+    try {
+      const results = await fetchSkillsShSearch(query, limit);
+      if (results.length === 0) {
+        console.log(import_picocolors2.default.yellow(`
+No skills found matching "${query}".
+`));
+        return;
+      }
+      console.log(import_picocolors2.default.cyan(`
+Found ${results.length} skills:
+`));
+      const maxNameLen = Math.max(...results.map((r) => r.name.length));
+      for (const result of results) {
+        const name = import_picocolors2.default.bold(result.name.padEnd(maxNameLen));
+        const source = import_picocolors2.default.gray(result.source);
+        const installs = import_picocolors2.default.green(`${result.installs.toLocaleString()} installs`);
+        console.log(`  ${name}  ${source}  ${installs}`);
+      }
+      console.log("");
+      console.log(import_picocolors2.default.gray(`  To embed: agdex skills embed --repo <owner/repo>`));
+      console.log("");
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      console.error(import_picocolors2.default.red(`Failed to search skills.sh: ${msg}`));
+      process.exit(1);
+    }
+    return;
+  }
+  console.log(import_picocolors2.default.cyan(`
+agdex - Search skills.sh
+`));
+  console.log(import_picocolors2.default.gray(`  Search the skills.sh ecosystem for agent skills.
+`));
+  const searchResponse = await import_prompts.default({
+    type: "text",
+    name: "query",
+    message: "Search skills",
+    validate: (v) => v.trim() ? true : "Please enter a search query"
+  }, { onCancel });
+  console.log(`
+${import_picocolors2.default.gray("Searching...")}`);
+  try {
+    const results = await fetchSkillsShSearch(searchResponse.query, limit);
+    if (results.length === 0) {
+      console.log(import_picocolors2.default.yellow(`
+No skills found matching "${searchResponse.query}".
+`));
+      return;
+    }
+    const choices = results.map((r) => ({
+      title: `${r.name} ${import_picocolors2.default.gray(`(${r.source})`)} ${import_picocolors2.default.green(`${r.installs.toLocaleString()}`)}`,
+      value: r
+    }));
+    const selectResponse = await import_prompts.default({
+      type: "select",
+      name: "skill",
+      message: "Select a skill to embed",
+      choices
+    }, { onCancel });
+    const selected = selectResponse.skill;
+    const repoName = selected.source;
+    console.log(`
+Selected ${import_picocolors2.default.bold(selected.name)} from ${import_picocolors2.default.cyan(repoName)}`);
+    const output = options.output || await promptForOutputFile();
+    await runSkillsEmbed({ repo: repoName, output });
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    console.error(import_picocolors2.default.red(`Failed to search skills.sh: ${msg}`));
+    process.exit(1);
+  }
+}
+skillsCommand.command("embed").description("Embed skills index into AGENTS.md").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("--plugin <path...>", "Additional plugin repo paths (with plugins/ structure)").option("--plugins", "Include enabled plugins from settings.json (default: true)").option("--no-plugins", "Exclude enabled plugins from settings.json").option("--user", "Include ~/.claude/skills (default: true)").option("--no-user", "Exclude ~/.claude/skills").option("--project", "Include .claude/skills (default: true)").option("--no-project", "Exclude .claude/skills").option("--repo <owner/repo>", "Fetch and index skills from a skills.sh-compatible GitHub repository").action(runSkillsEmbed);
 skillsCommand.command("list").description("List discovered skills").option("--plugin <path...>", "Additional plugin repo paths (with plugins/ structure)").option("--plugins", "Include enabled plugins from settings.json (default: true)").option("--no-plugins", "Exclude enabled plugins from settings.json").option("--user", "Include ~/.claude/skills (default: true)").option("--no-user", "Exclude ~/.claude/skills").option("--project", "Include .claude/skills (default: true)").option("--no-project", "Exclude .claude/skills").action(runSkillsList);
 skillsCommand.command("local <skills-path>").description("Index skills from a local path").option("-o, --output <file>", "Target file (default: from config or CLAUDE.md)").option("-n, --name <name>", "Label for this skill source").action(runSkillsLocal);
+skillsCommand.command("find [query]").description("Search skills.sh for agent skills").option("-l, --limit <n>", "Max results (default: 20)", parseInt).option("-o, --output <file>", "Target file for embedding").action(runSkillsFind);
 program2.parse();