plugins 1.0.0 → 1.1.0

package/dist/index.js

@@ -11,6 +11,130 @@ import { createInterface } from "readline";
 import { join } from "path";
 import { readFile, readdir, stat } from "fs/promises";
 import { existsSync } from "fs";
+
+// lib/ui.ts
+var isColorSupported = process.env.FORCE_COLOR !== "0" && !process.env.NO_COLOR && (process.env.FORCE_COLOR !== void 0 || process.stdout.isTTY);
+function ansi(code) {
+  return isColorSupported ? `\x1B[${code}m` : "";
+}
+var reset = ansi("0");
+var bold = ansi("1");
+var dim = ansi("2");
+var italic = ansi("3");
+var underline = ansi("4");
+var red = ansi("31");
+var green = ansi("32");
+var yellow = ansi("33");
+var blue = ansi("34");
+var magenta = ansi("35");
+var cyan = ansi("36");
+var gray = ansi("90");
+var bgGreen = ansi("42");
+var bgRed = ansi("41");
+var bgYellow = ansi("43");
+var bgCyan = ansi("46");
+var black = ansi("30");
+var c = {
+  bold: (s) => `${bold}${s}${reset}`,
+  dim: (s) => `${dim}${s}${reset}`,
+  italic: (s) => `${italic}${s}${reset}`,
+  underline: (s) => `${underline}${s}${reset}`,
+  red: (s) => `${red}${s}${reset}`,
+  green: (s) => `${green}${s}${reset}`,
+  yellow: (s) => `${yellow}${s}${reset}`,
+  blue: (s) => `${blue}${s}${reset}`,
+  magenta: (s) => `${magenta}${s}${reset}`,
+  cyan: (s) => `${cyan}${s}${reset}`,
+  gray: (s) => `${gray}${s}${reset}`,
+  bgGreen: (s) => `${bgGreen}${black}${s}${reset}`,
+  bgRed: (s) => `${bgRed}${black}${s}${reset}`,
+  bgYellow: (s) => `${bgYellow}${black}${s}${reset}`,
+  bgCyan: (s) => `${bgCyan}${black}${s}${reset}`
+};
+var S = {
+  // Box drawing
+  bar: "\u2502",
+  barEnd: "\u2514",
+  barStart: "\u250C",
+  barH: "\u2500",
+  corner: "\u256E",
+  // Bullets
+  diamond: "\u25C7",
+  diamondFilled: "\u25C6",
+  bullet: "\u25CF",
+  circle: "\u25CB",
+  check: "\u2714",
+  cross: "\u2716",
+  arrow: "\u2192",
+  warning: "\u25B2",
+  info: "\u2139",
+  step: "\u25C7",
+  stepActive: "\u25C6",
+  stepComplete: "\u25CF",
+  stepError: "\u25A0"
+};
+function barLine(content = "") {
+  console.log(`${c.gray(S.bar)}  ${content}`);
+}
+function barEmpty() {
+  console.log(`${c.gray(S.bar)}`);
+}
+function step(content) {
+  console.log(`${c.gray(S.step)}  ${content}`);
+}
+function stepDone(content) {
+  console.log(`${c.green(S.stepComplete)}  ${content}`);
+}
+function stepError(content) {
+  console.log(`${c.red(S.stepError)}  ${content}`);
+}
+function header(label) {
+  console.log();
+  console.log(`${c.gray(S.barStart)}  ${c.bgCyan(` ${label} `)}`);
+}
+function footer(message) {
+  if (message) {
+    console.log(`${c.gray(S.barEnd)}  ${message}`);
+  } else {
+    console.log(`${c.gray(S.barEnd)}`);
+  }
+}
+function error(title, details) {
+  console.log(`${c.red(S.stepError)}  ${c.red(c.bold(title))}`);
+  if (details) {
+    for (const line of details) {
+      barLine(c.dim(line));
+    }
+  }
+}
+var BANNER_LINES = [
+  "\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     \u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557",
+  "\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D",
+  "\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557",
+  "\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551",
+  "\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551",
+  "\u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D"
+];
+var GRADIENT = [
+  [60, 60, 60],
+  [90, 90, 90],
+  [125, 125, 125],
+  [160, 160, 160],
+  [200, 200, 200],
+  [240, 240, 240]
+];
+function rgb(r, g, b) {
+  return isColorSupported ? `\x1B[38;2;${r};${g};${b}m` : "";
+}
+function banner() {
+  console.log();
+  for (let i = 0; i < BANNER_LINES.length; i++) {
+    const [r, g, b] = GRADIENT[i];
+    console.log(`${rgb(r, g, b)}${BANNER_LINES[i]}${reset}`);
+  }
+}
+
+// lib/discover.ts
 async function discover(repoPath) {
   const marketplacePaths = [
     join(repoPath, "marketplace.json"),
@@ -54,7 +178,7 @@ async function discoverFromMarketplace(repoPath, marketplace) {
   for (const entry of marketplace.plugins) {
     const sourcePath = join(repoPath, root, entry.source.replace(/^\.\//, ""));
     if (!await dirExists(sourcePath)) {
-      console.warn(`  Warning: plugin source not found: ${entry.source}`);
+      barLine(`${c.yellow(S.warning)}  ${c.yellow(`Plugin source not found: ${entry.source}`)}`);
       continue;
     }
     let skills;
@@ -389,59 +513,60 @@ async function installPlugins(plugins, target, scope, repoPath, source) {
 }
 async function installToClaudeCode(plugins, scope, repoPath, source) {
   const marketplaceName = plugins[0]?.marketplace ?? deriveMarketplaceName(source);
-  console.log("\nPreparing plugins for Claude Code...");
+  step("Preparing plugins for Claude Code...");
+  barEmpty();
   await prepareForClaudeCode(plugins, repoPath, marketplaceName);
   const claudePath = findClaude();
-  console.log(`Adding marketplace from local path: ${repoPath}`);
-  console.log(`  Using claude binary: ${claudePath}`);
+  step("Adding marketplace");
+  barLine(c.dim(`Binary: ${claudePath}`));
   try {
     const version = execSync2(`${claudePath} --version`, { encoding: "utf-8", stdio: "pipe" }).trim();
-    console.log(`  Claude Code version: ${version}`);
+    barLine(c.dim(`Version: ${version}`));
   } catch {
-    console.log(`  Warning: could not get claude version`);
+    barLine(c.dim(`Warning: could not get claude version`));
   }
   try {
     const result = execSync2(`${claudePath} plugin marketplace add ${repoPath}`, {
       encoding: "utf-8",
       stdio: "pipe"
     });
-    console.log("  Marketplace added.");
-    if (result.trim()) console.log(`  Output: ${result.trim()}`);
+    if (result.trim()) barLine(c.dim(result.trim()));
+    stepDone("Marketplace added");
   } catch (err) {
     const stderr = err.stderr?.toString().trim() ?? "";
     const stdout = err.stdout?.toString().trim() ?? "";
     if (stderr.includes("already") || stdout.includes("already")) {
-      console.log("  Marketplace already registered.");
+      stepDone(`Marketplace ${c.dim("'" + marketplaceName + "'")} already on disk`);
     } else {
-      console.error(`Failed to add marketplace.`);
-      console.error(`  Command: ${claudePath} plugin marketplace add ${repoPath}`);
-      console.error(`  stdout: ${stdout}`);
-      console.error(`  stderr: ${stderr}`);
-      console.error(`  exit code: ${err.status}`);
+      stepError("Failed to add marketplace.");
+      barLine(c.dim(`Command: ${claudePath} plugin marketplace add ${repoPath}`));
+      if (stdout) barLine(c.dim(`stdout: ${stdout}`));
+      if (stderr) barLine(c.dim(`stderr: ${stderr}`));
+      barLine(c.dim(`exit code: ${err.status}`));
       process.exit(1);
     }
   }
+  barEmpty();
   for (const plugin of plugins) {
     const pluginRef = `${plugin.name}@${marketplaceName}`;
-    console.log(`
-Installing ${pluginRef}...`);
+    step(`Installing ${c.bold(pluginRef)}...`);
     try {
       execSync2(`${claudePath} plugin install ${pluginRef} --scope ${scope}`, {
         encoding: "utf-8",
         stdio: "pipe"
       });
-      console.log(`  Installed.`);
+      stepDone(`Installed ${c.cyan(pluginRef)}`);
     } catch (err) {
       const stderr = err.stderr?.toString().trim() ?? "";
       const stdout = err.stdout?.toString().trim() ?? "";
       if (stderr.includes("already") || stdout.includes("already")) {
-        console.log(`  Already installed.`);
+        stepDone(`${c.cyan(pluginRef)} ${c.dim("already installed")}`);
       } else {
-        console.error(`  Failed to install ${pluginRef}.`);
-        console.error(`  Command: ${claudePath} plugin install ${pluginRef} --scope ${scope}`);
-        console.error(`  stdout: ${stdout}`);
-        console.error(`  stderr: ${stderr}`);
-        console.error(`  exit code: ${err.status}`);
+        stepError(`Failed to install ${pluginRef}`);
+        barLine(c.dim(`Command: ${claudePath} plugin install ${pluginRef} --scope ${scope}`));
+        if (stdout) barLine(c.dim(`stdout: ${stdout}`));
+        if (stderr) barLine(c.dim(`stderr: ${stderr}`));
+        barLine(c.dim(`exit code: ${err.status}`));
       }
     }
   }
@@ -471,7 +596,7 @@ async function prepareForClaudeCode(plugins, repoPath, marketplaceName) {
     join3(claudePluginDir, "marketplace.json"),
     JSON.stringify(marketplaceJson, null, 2)
   );
-  console.log("  Generated .claude-plugin/marketplace.json");
+  barLine(c.dim("Generated .claude-plugin/marketplace.json"));
   for (const plugin of plugins) {
     await preparePluginDirForVendor(plugin, ".claude-plugin", "CLAUDE_PLUGIN_ROOT");
   }
@@ -501,7 +626,7 @@ async function preparePluginDirForVendor(plugin, vendorDir, envVar) {
   const hasVendorPlugin = existsSync2(join3(vendorPluginDir, "plugin.json"));
   if (hasOpenPlugin && !hasVendorPlugin) {
     await cp(openPluginDir, vendorPluginDir, { recursive: true });
-    console.log(`  ${plugin.name}: translated .plugin/ -> ${vendorDir}/`);
+    barLine(c.dim(`${plugin.name}: translated .plugin/ \u2192 ${vendorDir}/`));
   }
   if (!hasOpenPlugin && !hasVendorPlugin) {
     await mkdir(vendorPluginDir, { recursive: true });
@@ -517,7 +642,7 @@ async function preparePluginDirForVendor(plugin, vendorDir, envVar) {
         2
       )
     );
-    console.log(`  ${plugin.name}: generated ${vendorDir}/plugin.json`);
+    barLine(c.dim(`${plugin.name}: generated ${vendorDir}/plugin.json`));
   }
   await translateEnvVars(pluginPath, plugin.name, envVar);
 }
@@ -546,8 +671,8 @@ async function translateEnvVars(pluginPath, pluginName, envVar) {
     }
     if (changed) {
       await writeFile(filePath, content);
-      console.log(
-        `  ${pluginName}: translated plugin root -> \${${envVar}} in ${filePath.split("/").pop()}`
+      barLine(
+        c.dim(`${pluginName}: translated plugin root \u2192 \${${envVar}} in ${filePath.split("/").pop()}`)
       );
     }
   }
@@ -556,6 +681,13 @@ function deriveMarketplaceName(source) {
   if (source.match(/^[\w-]+\/[\w.-]+$/)) {
     return source.replace("/", "-");
   }
+  const sshMatch = source.match(/^git@[^:]+:(.+?)(?:\.git)?$/);
+  if (sshMatch) {
+    const parts2 = sshMatch[1].split("/").filter(Boolean);
+    if (parts2.length >= 2) {
+      return `${parts2[parts2.length - 2]}-${parts2[parts2.length - 1]}`;
+    }
+  }
   try {
     const url = new URL(source);
     const parts2 = url.pathname.replace(/\.git$/, "").split("/").filter(Boolean);
@@ -568,7 +700,41 @@ function deriveMarketplaceName(source) {
   return parts[parts.length - 1] ?? "plugins";
 }
 
+// lib/telemetry.ts
+var TELEMETRY_URL = "https://plugins-telemetry.labs.vercel.dev/t";
+var cliVersion = null;
+function isCI() {
+  return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.CIRCLECI || process.env.TRAVIS || process.env.BUILDKITE || process.env.JENKINS_URL || process.env.TEAMCITY_VERSION);
+}
+function isEnabled() {
+  return !process.env.DISABLE_TELEMETRY && !process.env.DO_NOT_TRACK;
+}
+function setVersion(version) {
+  cliVersion = version;
+}
+function track(data) {
+  if (!isEnabled()) return;
+  try {
+    const params = new URLSearchParams();
+    if (cliVersion) {
+      params.set("v", cliVersion);
+    }
+    if (isCI()) {
+      params.set("ci", "1");
+    }
+    for (const [key, value] of Object.entries(data)) {
+      if (value !== void 0 && value !== null) {
+        params.set(key, String(value));
+      }
+    }
+    fetch(`${TELEMETRY_URL}?${params.toString()}`).catch(() => {
+    });
+  } catch {
+  }
+}
+
 // index.ts
+setVersion("1.0.1");
 var { values, positionals } = parseArgs({
   args: process.argv.slice(2),
   options: {
@@ -600,62 +766,79 @@ switch (command) {
 }
 function printUsage() {
   console.log(`
-plugins - Install open-plugin format plugins into agent tools
+${c.bold("plugins")} \u2014 Install open-plugin format plugins into agent tools
 
-Usage:
-  plugins add <repo-path-or-url>          Install plugins from a repo
-  plugins discover <repo-path-or-url>     Discover plugins in a repo
-  plugins targets                         List available install targets
-  plugins <repo-path-or-url>              Shorthand for add
+${c.dim("Usage:")}
+  ${c.cyan("plugins add")} <repo-path-or-url>          Install plugins from a repo
+  ${c.cyan("plugins discover")} <repo-path-or-url>     Discover plugins in a repo
+  ${c.cyan("plugins targets")}                         List available install targets
+  ${c.cyan("plugins")} <repo-path-or-url>              Shorthand for add
 
-Options:
-  -t, --target <target>   Target tool (e.g. claude-code). Default: auto-detect
-  -s, --scope <scope>     Install scope: user, project, local. Default: user
-  -y, --yes               Skip confirmation prompts
-  -h, --help              Show this help
+${c.dim("Options:")}
+  ${c.yellow("-t, --target")} <target>   Target tool (e.g. claude-code). Default: auto-detect
+  ${c.yellow("-s, --scope")} <scope>     Install scope: user, project, local. Default: user
+  ${c.yellow("-y, --yes")}               Skip confirmation prompts
+  ${c.yellow("-h, --help")}              Show this help
 `);
 }
 async function cmdDiscover(source) {
   if (!source) {
-    console.error("Error: provide a repo path or URL");
+    error("Provide a repo path or URL");
     process.exit(1);
   }
+  banner();
+  header("plugins");
   const repoPath = resolveSource(source);
   const plugins = await discover(repoPath);
   if (plugins.length === 0) {
-    console.log("No plugins found.");
+    barEmpty();
+    step("No plugins found.");
+    footer();
     return;
   }
-  console.log(`Found ${plugins.length} plugin(s) in ${source}:
-`);
+  barEmpty();
+  step(`Found ${c.bold(String(plugins.length))} plugin(s) in ${c.dim(source)}`);
+  barEmpty();
   for (const p of plugins) {
     printPlugin(p);
   }
+  footer();
 }
 async function cmdTargets() {
   const targets = await getTargets();
+  banner();
+  header("plugins");
   if (targets.length === 0) {
-    console.log("No supported targets detected.");
+    barEmpty();
+    step("No supported targets detected.");
+    footer();
     return;
   }
-  console.log("Available install targets:\n");
+  barEmpty();
+  step("Available install targets");
+  barEmpty();
   for (const t of targets) {
-    console.log(`  ${t.name}`);
-    console.log(`    ${t.description}`);
-    console.log(`    Config: ${t.configPath}`);
-    console.log(`    Status: ${t.detected ? "detected" : "not found"}`);
-    console.log();
+    barLine(`  ${c.bold(t.name)}`);
+    barLine(`  ${c.dim(t.description)}`);
+    barLine(`  Config: ${c.dim(t.configPath)}`);
+    barLine(`  Status: ${t.detected ? c.green("detected") : c.dim("not found")}`);
+    barEmpty();
   }
+  footer();
 }
 async function cmdInstall(source, opts) {
   if (!source) {
-    console.error("Error: provide a repo path or URL");
+    error("Provide a repo path or URL");
     process.exit(1);
   }
+  banner();
+  header("plugins");
   const repoPath = resolveSource(source);
   const plugins = await discover(repoPath);
   if (plugins.length === 0) {
-    console.log("No plugins found.");
+    barEmpty();
+    step("No plugins found.");
+    footer();
     return;
   }
   const targets = await getTargets();
@@ -664,29 +847,36 @@ async function cmdInstall(source, opts) {
   if (opts.target) {
     const found = targets.find((t) => t.id === opts.target);
     if (!found) {
-      console.error(`Unknown target: ${opts.target}`);
-      console.error(`Available: ${targets.map((t) => t.id).join(", ")}`);
+      barEmpty();
+      stepError(`Unknown target: ${c.bold(opts.target)}`);
+      barLine(c.dim(`Available: ${targets.map((t) => t.id).join(", ")}`));
+      footer();
       process.exit(1);
     }
     installTargets = [found];
   } else if (detectedTargets.length === 0) {
-    console.error("No supported targets detected. Use --target to specify one.");
+    barEmpty();
+    stepError("No supported targets detected.");
+    barLine(c.dim("Use --target to specify one."));
+    footer();
     process.exit(1);
   } else {
     installTargets = detectedTargets;
   }
-  console.log(`Found ${plugins.length} plugin(s):
-`);
+  barEmpty();
+  step(`Found ${c.bold(String(plugins.length))} plugin(s)`);
+  barEmpty();
   for (const p of plugins) {
     printPlugin(p);
   }
-  console.log(`Targets: ${installTargets.map((t) => t.name).join(", ")}`);
-  console.log(`Scope: ${opts.scope ?? "user"}
-`);
+  barLine(`${c.dim("Targets:")}  ${installTargets.map((t) => c.cyan(t.name)).join(c.dim(", "))}`);
+  barLine(`${c.dim("Scope:")}    ${c.cyan(opts.scope ?? "user")}`);
+  barEmpty();
   if (!opts.yes) {
-    const response = await readLine("Install? [y/N] ");
-    if (response.trim().toLowerCase() !== "y") {
-      console.log("Aborted.");
+    const response = await readLine(`${c.cyan(S.stepActive)}  Install? ${c.dim("[Y/n]")} `);
+    if (response.trim().toLowerCase() === "n") {
+      step("Aborted.");
+      footer();
       return;
     }
   }
@@ -694,11 +884,21 @@ async function cmdInstall(source, opts) {
   for (const target of installTargets) {
     await installPlugins(plugins, target, scope, repoPath, source);
   }
-  console.log("\nDone. Restart your agent tools to load the plugins.");
+  track({
+    event: "install",
+    source,
+    plugins: plugins.map((p) => p.name).join(","),
+    pluginCount: String(plugins.length),
+    targets: installTargets.map((t) => t.id).join(","),
+    scope
+  });
+  barEmpty();
+  stepDone(c.green("Done.") + "  Restart your agent tools to load the plugins.");
+  footer();
 }
 function printPlugin(p) {
-  console.log(`  ${p.name} (v${p.version ?? "0.0.0"})`);
-  if (p.description) console.log(`    ${p.description}`);
+  barLine(`${c.bold(p.name)} ${p.version ? c.dim(`(v${p.version})`) : ""}`);
+  if (p.description) barLine(`${c.dim(p.description)}`);
   const parts = [];
   if (p.skills.length) parts.push(`${p.skills.length} skill(s)`);
   if (p.commands.length) parts.push(`${p.commands.length} command(s)`);
@@ -707,21 +907,71 @@ function printPlugin(p) {
   if (p.hasHooks) parts.push("hooks");
   if (p.hasMcp) parts.push("MCP servers");
   if (p.hasLsp) parts.push("LSP servers");
-  if (parts.length) console.log(`    Components: ${parts.join(", ")}`);
-  console.log();
+  if (parts.length) barLine(`${c.dim("Components:")} ${parts.join(c.dim(", "))}`);
+  barEmpty();
+}
+function sshToHttps(sshUrl) {
+  const m = sshUrl.match(/^git@([^:]+):(.+)$/);
+  if (!m) return null;
+  return `https://${m[1]}/${m[2]}`;
 }
 function resolveSource(source) {
   if (source.startsWith("https://") || source.startsWith("git@") || source.match(/^[\w-]+\/[\w.-]+$/)) {
     const url = source.match(/^[\w-]+\/[\w.-]+$/) ? `https://github.com/${source}` : source;
     const cacheDir = join4(process.env.HOME ?? "~", ".cache", "plugins");
     mkdirSync(cacheDir, { recursive: true });
-    const slug = url.replace(/^https?:\/\//, "").replace(/\.git$/, "").replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+    const slug = url.replace(/^https?:\/\//, "").replace(/^git@/, "").replace(/\.git$/, "").replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
     const tmpDir = join4(cacheDir, slug);
     if (existsSync3(join4(tmpDir, ".git", "HEAD"))) {
       rmSync(tmpDir, { recursive: true, force: true });
     }
-    console.log(`Cloning ${url}...`);
-    execSync3(`git clone --depth 1 -q ${url} ${tmpDir}`, { stdio: "inherit" });
+    step(`Source: ${c.dim(url)}`);
+    barEmpty();
+    try {
+      execSync3(`git clone --depth 1 -q ${url} ${tmpDir}`, { stdio: "pipe" });
+    } catch (err) {
+      const stderr = err.stderr?.toString() ?? "";
+      if (url.startsWith("git@") && stderr.includes("Permission denied")) {
+        const httpsUrl = sshToHttps(url);
+        if (httpsUrl) {
+          barLine(c.yellow("SSH authentication failed. Retrying over HTTPS..."));
+          step(`Source: ${c.dim(httpsUrl)}`);
+          barEmpty();
+          try {
+            execSync3(`git clone --depth 1 -q ${httpsUrl} ${tmpDir}`, { stdio: "inherit" });
+            stepDone("Repository cloned");
+            barEmpty();
+            return tmpDir;
+          } catch {
+          }
+        }
+      }
+      if (existsSync3(tmpDir)) {
+        rmSync(tmpDir, { recursive: true, force: true });
+      }
+      if (stderr.includes("Permission denied") || stderr.includes("Could not read from remote repository")) {
+        barEmpty();
+        stepError(`Could not access ${c.bold(url)}`);
+        barEmpty();
+        barLine(c.dim("Make sure you have access to this repository. For private repos, try:"));
+        barLine(`  ${c.dim("HTTPS:")} plugins add https://github.com/owner/repo`);
+        barLine(`  ${c.dim("       (uses git credential helper / browser auth)")}`);
+        barLine(`  ${c.dim("SSH:")}   plugins add git@github.com:owner/repo.git`);
+        barLine(`  ${c.dim("       (requires SSH keys)")}`);
+      } else if (stderr.includes("not found") || stderr.includes("does not exist") || err.status === 128) {
+        barEmpty();
+        stepError(`Repository not found: ${c.bold(url)}`);
+        barLine(c.dim("Check that the URL is correct and the repository exists."));
+      } else {
+        barEmpty();
+        stepError("git clone failed.");
+        if (stderr.trim()) barLine(c.dim(stderr.trim()));
+      }
+      footer();
+      process.exit(1);
+    }
+    stepDone("Repository cloned");
+    barEmpty();
     return tmpDir;
   }
   return resolve(source);
@@ -731,6 +981,7 @@ function readLine(prompt) {
   return new Promise((resolve2) => {
     rl.question(prompt, (answer) => {
       rl.close();
+      if (!process.stdin.isTTY) process.stdout.write("\n");
       resolve2(answer);
     });
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plugins",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Install open-plugin format plugins into agent tools",
   "type": "module",
   "bin": {