plugins 1.3.0 → 1.3.1

package/README.md

@@ -42,31 +42,31 @@ npx plugins targets
 
 ## Commands
 
-| Command | Description |
-|---|---|
-| `plugins add <source>` | Discover and install plugins from a source |
-| `plugins discover <source>` | Inspect plugins without installing (dry run) |
-| `plugins targets` | List available agent tools and their detection status |
+| Command                     | Description                                           |
+| --------------------------- | ----------------------------------------------------- |
+| `plugins add <source>`      | Discover and install plugins from a source            |
+| `plugins discover <source>` | Inspect plugins without installing (dry run)          |
+| `plugins targets`           | List available agent tools and their detection status |
 
 If no subcommand is given, `plugins <source>` defaults to `add`.
 
 ## Flags
 
-| Flag | Short | Default | Description |
-|---|---|---|---|
-| `--target` | `-t` | auto-detect | Install to a specific agent tool (`claude-code`, `cursor`) |
-| `--scope` | `-s` | `user` | Installation scope: `user`, `project`, or `local` |
-| `--yes` | `-y` | `false` | Skip the confirmation prompt |
-| `--help` | `-h` | | Show usage information |
+| Flag       | Short | Default     | Description                                                |
+| ---------- | ----- | ----------- | ---------------------------------------------------------- |
+| `--target` | `-t`  | auto-detect | Install to a specific agent tool (`claude-code`, `cursor`) |
+| `--scope`  | `-s`  | `user`      | Installation scope: `user`, `project`, or `local`          |
+| `--yes`    | `-y`  | `false`     | Skip the confirmation prompt                               |
+| `--help`   | `-h`  |             | Show usage information                                     |
 
 ## Supported targets
 
 The CLI auto-detects which agent tools are installed and installs to all of them.
 
-| Target | Detection |
-|---|---|
-| [Claude Code](https://code.claude.com) | `claude` binary on PATH |
-| [Cursor](https://cursor.com) | `cursor` + `claude` binaries on PATH |
+| Target                                 | Detection                            |
+| -------------------------------------- | ------------------------------------ |
+| [Claude Code](https://code.claude.com) | `claude` binary on PATH              |
+| [Cursor](https://cursor.com)           | `cursor` + `claude` binaries on PATH |
 
 ## How it works
 
@@ -90,12 +90,12 @@ The CLI translates the vendor-neutral `.plugin/` format into target-specific for
 
 ## Environment variables
 
-| Variable | Purpose |
-|---|---|
-| `DISABLE_TELEMETRY` | Disable anonymous install telemetry |
-| `DO_NOT_TRACK` | Disable anonymous install telemetry ([standard](https://consoledonottrack.com/)) |
-| `NO_COLOR` | Disable color output |
-| `FORCE_COLOR` | Force color output |
+| Variable            | Purpose                                                                          |
+| ------------------- | -------------------------------------------------------------------------------- |
+| `DISABLE_TELEMETRY` | Disable anonymous install telemetry                                              |
+| `DO_NOT_TRACK`      | Disable anonymous install telemetry ([standard](https://consoledonottrack.com/)) |
+| `NO_COLOR`          | Disable color output                                                             |
+| `FORCE_COLOR`       | Force color output                                                               |
 
 ## Development
 
@@ -109,4 +109,4 @@ Zero runtime dependencies. Built with [tsup](https://tsup.egoist.dev/) as a sing
 
 ## License
 
-[Apache 2.0](../../LICENSE)
+[Apache 2.0](./LICENSE)

package/dist/index.js

@@ -540,7 +540,9 @@ async function multiSelect(title, options, maxVisible = 8) {
       if (state === "active") {
         const blockCursor = isColorSupported ? `\x1B[7m \x1B[0m` : "_";
         lines.push(`${c.gray(S.bar)}  ${c.dim("Search:")} ${query}${blockCursor}`);
-        lines.push(`${c.gray(S.bar)}  ${c.dim("\u2191\u2193 move, space toggle, a all, n none, enter confirm")}`);
+        lines.push(
+          `${c.gray(S.bar)}  ${c.dim("\u2191\u2193 move, space toggle, a all, n none, enter confirm")}`
+        );
         lines.push(`${c.gray(S.bar)}`);
         const visibleStart = Math.max(
           0,
@@ -689,6 +691,15 @@ var cachePopulated = false;
 async function installPlugins(plugins, target, scope, repoPath, source) {
   switch (target.id) {
     case "claude-code": {
+      const officialRef = getOfficialPluginRef(source);
+      if (officialRef) {
+        const ok = await installViaClaudeCli(officialRef, scope);
+        if (ok) {
+          cachePopulated = true;
+          break;
+        }
+        barDebug(c.dim("Falling back to direct file-based install"));
+      }
       const workspace = await stageInstallWorkspace(plugins, repoPath, target.id);
       await installToClaudeCode(workspace.plugins, scope, workspace.repoPath, source);
       break;
@@ -727,6 +738,47 @@ async function stageInstallWorkspace(plugins, repoPath, targetId, stagingBaseDir
     plugins: stagedPlugins
   };
 }
+var OFFICIAL_MARKETPLACE_SOURCE = "anthropics/claude-plugins-official";
+function getOfficialPluginRef(source) {
+  let repo = null;
+  const shorthand = source.match(/^([\w.-]+\/[\w.-]+?)(?:\.git)?$/);
+  if (shorthand) repo = shorthand[1].toLowerCase();
+  if (!repo) {
+    const https = source.match(/^https?:\/\/github\.com\/([\w.-]+\/[\w.-]+?)(?:\.git)?$/);
+    if (https) repo = https[1].toLowerCase();
+  }
+  if (!repo) {
+    const ssh = source.match(/^git@github\.com:([\w.-]+\/[\w.-]+?)(?:\.git)?$/);
+    if (ssh) repo = ssh[1].toLowerCase();
+  }
+  if (repo === "vercel/vercel-plugin") {
+    return "vercel@claude-plugins-official";
+  }
+  return null;
+}
+async function installViaClaudeCli(pluginRef, scope) {
+  const claude = findClaudeOrNull();
+  if (!claude) return false;
+  try {
+    step("Registering official Claude marketplace");
+    execSync2(`${claude} plugin marketplace add ${OFFICIAL_MARKETPLACE_SOURCE}`, {
+      stdio: "pipe",
+      timeout: 12e4
+    });
+    stepDone("Official marketplace registered");
+    step(`Installing ${c.cyan(pluginRef)} via Claude CLI`);
+    execSync2(`${claude} plugin install "${pluginRef}" --scope ${scope}`, {
+      stdio: "pipe",
+      timeout: 12e4
+    });
+    stepDone(`Installed ${c.cyan(pluginRef)} via Claude CLI`);
+    return true;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    barDebug(c.dim(`Claude CLI install failed: ${msg}`));
+    return false;
+  }
+}
 async function installToClaudeCode(plugins, scope, repoPath, source) {
   await installToPluginCache(plugins, scope, repoPath, source);
 }
@@ -773,7 +825,10 @@ async function installToPluginCache(plugins, scope, repoPath, source) {
       marketplaceSource = { source: "github", repo: githubRepo };
     } else if (isRemoteSource(source)) {
       const gitUrl = normalizeGitUrl(source);
-      marketplaceSource = { source: "git", url: gitUrl.endsWith(".git") ? gitUrl : gitUrl + ".git" };
+      marketplaceSource = {
+        source: "git",
+        url: gitUrl.endsWith(".git") ? gitUrl : gitUrl + ".git"
+      };
     } else {
       marketplaceSource = { source: "directory", path: repoPath };
     }
@@ -787,16 +842,25 @@ async function installToPluginCache(plugins, scope, repoPath, source) {
   }
   barEmpty();
   const installedPath = join3(pluginsDir, "installed_plugins.json");
-  let installedData = { version: 2, plugins: {} };
+  let installedData = {
+    version: 2,
+    plugins: {}
+  };
   if (existsSync2(installedPath)) {
     try {
-      installedData = JSON.parse(await readFile2(installedPath, "utf-8"));
+      const parsed = JSON.parse(await readFile2(installedPath, "utf-8"));
+      installedData.version = parsed.version ?? 2;
+      installedData.plugins = parsed.plugins ?? {};
     } catch {
     }
   }
   let gitSha;
   try {
-    gitSha = execSync2("git rev-parse HEAD", { cwd: repoPath, encoding: "utf-8", stdio: "pipe" }).trim();
+    gitSha = execSync2("git rev-parse HEAD", {
+      cwd: repoPath,
+      encoding: "utf-8",
+      stdio: "pipe"
+    }).trim();
   } catch {
   }
   for (const plugin of plugins) {
@@ -834,7 +898,9 @@ async function installToPluginCache(plugins, scope, repoPath, source) {
     }
   }
   if (settingsCorrupted) {
-    warn("Could not parse ~/.claude/settings.json \u2014 skipping enabledPlugins update to avoid overwriting existing settings.");
+    warn(
+      "Could not parse ~/.claude/settings.json \u2014 skipping enabledPlugins update to avoid overwriting existing settings."
+    );
     barLine(c.dim("You may need to manually enable the plugins in Claude Code settings."));
   } else {
     const enabled = settings.enabledPlugins ?? {};
@@ -867,7 +933,11 @@ async function installToCursorExtensions(plugins, scope, repoPath, source) {
   }
   let gitSha;
   try {
-    gitSha = execSync2("git rev-parse HEAD", { cwd: repoPath, encoding: "utf-8", stdio: "pipe" }).trim();
+    gitSha = execSync2("git rev-parse HEAD", {
+      cwd: repoPath,
+      encoding: "utf-8",
+      stdio: "pipe"
+    }).trim();
   } catch {
   }
   for (const plugin of plugins) {
@@ -881,9 +951,7 @@ async function installToCursorExtensions(plugins, scope, repoPath, source) {
     await cp(plugin.path, destDir, { recursive: true });
     barDebug(c.dim(`Copied to ${destDir}`));
     const identifier = `${marketplaceName}.${plugin.name}`;
-    extensions = extensions.filter(
-      (e) => e?.identifier?.id !== identifier
-    );
+    extensions = extensions.filter((e) => e?.identifier?.id !== identifier);
     const uriPath = "/" + destDir.replace(/\\/g, "/");
     extensions.push({
       identifier: { id: identifier },
@@ -917,7 +985,11 @@ async function installToCodex(plugins, scope, repoPath, source) {
   }
   let gitSha;
   try {
-    gitSha = execSync2("git rev-parse HEAD", { cwd: repoPath, encoding: "utf-8", stdio: "pipe" }).trim();
+    gitSha = execSync2("git rev-parse HEAD", {
+      cwd: repoPath,
+      encoding: "utf-8",
+      stdio: "pipe"
+    }).trim();
   } catch {
   }
   const versionKey = gitSha ?? "local";
@@ -1031,7 +1103,12 @@ async function enrichForCodex(plugin) {
   };
   if (manifest.homepage) iface.websiteURL = manifest.homepage;
   else if (manifest.repository) iface.websiteURL = manifest.repository;
-  const assetCandidates = ["assets/app-icon.png", "assets/icon.png", "assets/logo.png", "assets/logo.svg"];
+  const assetCandidates = [
+    "assets/app-icon.png",
+    "assets/icon.png",
+    "assets/logo.png",
+    "assets/logo.svg"
+  ];
   for (const candidate of assetCandidates) {
     if (existsSync2(join3(plugin.path, candidate))) {
       iface.logo = `./${candidate}`;
@@ -1076,6 +1153,23 @@ async function prepareForClaudeCode(plugins, repoPath, marketplaceName) {
     await preparePluginDirForVendor(plugin, ".claude-plugin", "CLAUDE_PLUGIN_ROOT");
   }
 }
+function findClaudeOrNull() {
+  try {
+    const path = execSync2("which claude", { encoding: "utf-8", stdio: "pipe" }).trim();
+    if (path) return path;
+  } catch {
+  }
+  const home = homedir2();
+  const candidates = [
+    join3(home, ".local", "bin", "claude"),
+    join3(home, ".bun", "bin", "claude"),
+    "/usr/local/bin/claude"
+  ];
+  for (const candidate of candidates) {
+    if (existsSync2(candidate)) return candidate;
+  }
+  return null;
+}
 async function preparePluginDirForVendor(plugin, vendorDir, envVar) {
   const pluginPath = plugin.path;
   const openPluginDir = join3(pluginPath, ".plugin");
@@ -1131,7 +1225,9 @@ async function translateEnvVars(pluginPath, pluginName, envVar) {
     if (changed) {
       await writeFile(filePath, content);
       barDebug(
-        c.dim(`${pluginName}: translated plugin root \u2192 \${${envVar}} in ${filePath.split("/").pop()}`)
+        c.dim(
+          `${pluginName}: translated plugin root \u2192 \${${envVar}} in ${filePath.split("/").pop()}`
+        )
       );
     }
   }
@@ -1183,6 +1279,29 @@ function normalizeGitUrl(source) {
   }
   return source;
 }
+async function isMarketplaceNew(marketplaceName) {
+  const knownPath = join3(homedir2(), ".claude", "plugins", "known_marketplaces.json");
+  if (!existsSync2(knownPath)) return true;
+  try {
+    const data = JSON.parse(await readFile2(knownPath, "utf-8"));
+    return !data[marketplaceName];
+  } catch {
+    return true;
+  }
+}
+async function setAutoUpdate(marketplaceName, enabled) {
+  const knownPath = join3(homedir2(), ".claude", "plugins", "known_marketplaces.json");
+  if (!existsSync2(knownPath)) return;
+  let data = {};
+  try {
+    data = JSON.parse(await readFile2(knownPath, "utf-8"));
+  } catch {
+    return;
+  }
+  if (!data[marketplaceName]) return;
+  data[marketplaceName].autoUpdate = enabled;
+  await writeFile(knownPath, JSON.stringify(data, null, 2));
+}
 
 // lib/telemetry.ts
 var TELEMETRY_URL = "https://plugins-telemetry.labs.vercel.dev/t";
@@ -1294,14 +1413,14 @@ async function cmdDiscover(source) {
   if (remotePlugins.length > 0) {
     if (values.remote) {
       barEmpty();
-      step(`${c.bold(String(remotePlugins.length))} remote plugin(s) ${c.dim("(hosted in external repos)")}`);
+      step(
+        `${c.bold(String(remotePlugins.length))} remote plugin(s) ${c.dim("(hosted in external repos)")}`
+      );
       barEmpty();
       printRemotePluginTable(remotePlugins);
     } else {
       barEmpty();
-      barLine(
-        c.dim(`${remotePlugins.length} remote plugin(s) not shown. Run:`)
-      );
+      barLine(c.dim(`${remotePlugins.length} remote plugin(s) not shown. Run:`));
       barLine(`  ${c.cyan(`npx plugins discover ${source} --remote`)}`);
     }
     printMissingPaths(missingPaths);
@@ -1343,9 +1462,7 @@ async function cmdInstall(source, opts) {
     barEmpty();
     step("No plugins found.");
     if (remotePlugins.length > 0) {
-      barLine(
-        c.dim(`${remotePlugins.length} remote plugin(s) not shown. Run:`)
-      );
+      barLine(c.dim(`${remotePlugins.length} remote plugin(s) not shown. Run:`));
       barLine(`  ${c.cyan(`npx plugins discover ${source} --remote`)}`);
       printMissingPaths(missingPaths);
     }
@@ -1387,9 +1504,7 @@ async function cmdInstall(source, opts) {
     printPluginTable(plugins);
     if (remotePlugins.length > 0) {
       barEmpty();
-      barLine(
-        c.dim(`+ ${remotePlugins.length} remote plugin(s) not included. Run:`)
-      );
+      barLine(c.dim(`+ ${remotePlugins.length} remote plugin(s) not included. Run:`));
       barLine(`  ${c.cyan(`npx plugins discover ${source} --remote`)}`);
       printMissingPaths(missingPaths);
     }
@@ -1422,9 +1537,7 @@ async function cmdInstall(source, opts) {
     }
     selectedPlugins = plugins.filter((p) => selected.includes(p.name));
     if (remotePlugins.length > 0) {
-      barLine(
-        c.dim(`+ ${remotePlugins.length} remote plugin(s) not included. Run:`)
-      );
+      barLine(c.dim(`+ ${remotePlugins.length} remote plugin(s) not included. Run:`));
       barLine(`  ${c.cyan(`npx plugins discover ${source} --remote`)}`);
       printMissingPaths(missingPaths);
     }
@@ -1434,9 +1547,29 @@ async function cmdInstall(source, opts) {
     barEmpty();
   }
   const scope = opts.scope ?? "user";
+  const marketplaceName = selectedPlugins[0]?.marketplace ?? deriveMarketplaceName(source);
+  const willInstallToClaude = installTargets.some(
+    (t) => t.id === "claude-code" || t.id === "cursor" && process.platform !== "win32"
+  );
+  const isNew = willInstallToClaude && await isMarketplaceNew(marketplaceName);
   for (const target of installTargets) {
     await installPlugins(selectedPlugins, target, scope, repoPath, source);
   }
+  const installedViaOfficialCli = !!getOfficialPluginRef(source);
+  if (isNew && willInstallToClaude && !installedViaOfficialCli) {
+    let enableAutoUpdate = true;
+    if (!opts.yes && process.stdin.isTTY) {
+      barEmpty();
+      const response = await readLine(
+        `${c.cyan(S.stepActive)}  Enable auto-updates? ${c.dim("[Y/n]")} `
+      );
+      enableAutoUpdate = response.trim().toLowerCase() !== "n";
+    }
+    if (enableAutoUpdate) {
+      await setAutoUpdate(marketplaceName, true);
+      stepDone("Auto-updates enabled");
+    }
+  }
   track({
     event: "install",
     source,
@@ -1451,9 +1584,12 @@ async function cmdInstall(source, opts) {
 }
 function pluginComponents(p) {
   const parts = [];
-  if (p.skills.length) parts.push(`${p.skills.length} ${p.skills.length === 1 ? "skill" : "skills"}`);
-  if (p.commands.length) parts.push(`${p.commands.length} ${p.commands.length === 1 ? "cmd" : "cmds"}`);
-  if (p.agents.length) parts.push(`${p.agents.length} ${p.agents.length === 1 ? "agent" : "agents"}`);
+  if (p.skills.length)
+    parts.push(`${p.skills.length} ${p.skills.length === 1 ? "skill" : "skills"}`);
+  if (p.commands.length)
+    parts.push(`${p.commands.length} ${p.commands.length === 1 ? "cmd" : "cmds"}`);
+  if (p.agents.length)
+    parts.push(`${p.agents.length} ${p.agents.length === 1 ? "agent" : "agents"}`);
   if (p.rules.length) parts.push(`${p.rules.length} ${p.rules.length === 1 ? "rule" : "rules"}`);
   if (p.hasHooks) parts.push("hooks");
   if (p.hasMcp) parts.push("mcp");
@@ -1471,7 +1607,9 @@ function printPluginTable(plugins) {
     const name = p.name.padEnd(nameWidth);
     const comp = compStrs[i];
     const desc = truncate(p.description ?? "", descWidth);
-    barLine(`${c.bold(name)}  ${comp ? c.cyan(comp.padEnd(compWidth)) : " ".repeat(compWidth)}  ${c.dim(desc)}`);
+    barLine(
+      `${c.bold(name)}  ${comp ? c.cyan(comp.padEnd(compWidth)) : " ".repeat(compWidth)}  ${c.dim(desc)}`
+    );
   }
 }
 function printRemotePluginTable(plugins) {

package/package.json

@@ -1,20 +1,35 @@
 {
   "name": "plugins",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Install open-plugin format plugins into agent tools",
   "type": "module",
+  "packageManager": "pnpm@10.28.1",
+  "engines": {
+    "node": ">=18"
+  },
   "bin": {
     "plugins": "dist/index.js"
   },
   "files": [
     "dist"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vercel-labs/plugins.git"
+  },
+  "homepage": "https://github.com/vercel-labs/plugins#readme",
+  "bugs": {
+    "url": "https://github.com/vercel-labs/plugins/issues"
+  },
   "scripts": {
     "build": "tsup",
     "start": "node dist/index.js",
-    "test": "tsx --test test/*.test.ts"
+    "test": "tsx --test test/*.test.ts",
+    "format:check": "prettier --check \"index.ts\" \"lib/**/*.ts\" \"test/**/*.ts\"",
+    "publish:snapshot": "npm version prerelease --preid=snapshot --no-git-tag-version && npm publish --tag snapshot"
   },
   "devDependencies": {
+    "prettier": "^3",
     "tsx": "^4.20.6",
     "tsup": "^8",
     "typescript": "^5"