plugins 1.2.10-canary.5 → 1.3.1-snapshot.0

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

@@ -488,6 +488,9 @@ function error(title, details) {
     }
   }
 }
+function warn(message) {
+  barLine(`${c.yellow(S.warning)}  ${c.yellow(message)}`);
+}
 async function multiSelect(title, options, maxVisible = 8) {
   if (!process.stdin.isTTY) {
     return options.map((o) => o.value);
@@ -770,7 +773,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 };
     }
@@ -784,7 +790,10 @@ 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"));
@@ -793,7 +802,11 @@ async function installToPluginCache(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) {
@@ -822,20 +835,29 @@ async function installToPluginCache(plugins, scope, repoPath, source) {
   barDebug(c.dim("Updated installed_plugins.json"));
   const settingsPath = join3(home, ".claude", "settings.json");
   let settings = {};
+  let settingsCorrupted = false;
   if (existsSync2(settingsPath)) {
     try {
       settings = JSON.parse(await readFile2(settingsPath, "utf-8"));
     } catch {
+      settingsCorrupted = true;
     }
   }
-  const enabled = settings.enabledPlugins ?? {};
-  for (const plugin of plugins) {
-    const pluginKey = `${plugin.name}@${marketplaceName}`;
-    enabled[pluginKey] = true;
+  if (settingsCorrupted) {
+    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 ?? {};
+    for (const plugin of plugins) {
+      const pluginKey = `${plugin.name}@${marketplaceName}`;
+      enabled[pluginKey] = true;
+    }
+    settings.enabledPlugins = enabled;
+    await writeFile(settingsPath, JSON.stringify(settings, null, 2));
+    barDebug(c.dim("Updated settings.json enabledPlugins"));
   }
-  settings.enabledPlugins = enabled;
-  await writeFile(settingsPath, JSON.stringify(settings, null, 2));
-  barDebug(c.dim("Updated settings.json enabledPlugins"));
   cachePopulated = true;
 }
 async function installToCursorExtensions(plugins, scope, repoPath, source) {
@@ -857,7 +879,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) {
@@ -871,9 +897,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 },
@@ -907,7 +931,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";
@@ -1021,7 +1049,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}`;
@@ -1121,7 +1154,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()}`
+        )
       );
     }
   }

package/package.json

@@ -1,20 +1,35 @@
 {
   "name": "plugins",
-  "version": "1.2.10-canary.5",
+  "version": "1.3.1-snapshot.0",
   "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"