plugins 1.2.4 → 1.2.7

package/dist/index.js

@@ -5,6 +5,7 @@ import { parseArgs } from "util";
 import { resolve, join as join4 } from "path";
 import { execSync as execSync3 } from "child_process";
 import { existsSync as existsSync3, rmSync, mkdirSync } from "fs";
+import { homedir as homedir3 } from "os";
 import { createInterface } from "readline";
 
 // lib/discover.ts
@@ -16,7 +17,8 @@ async function discover(repoPath) {
     join(repoPath, "marketplace.json"),
     join(repoPath, ".plugin", "marketplace.json"),
     join(repoPath, ".claude-plugin", "marketplace.json"),
-    join(repoPath, ".cursor-plugin", "marketplace.json")
+    join(repoPath, ".cursor-plugin", "marketplace.json"),
+    join(repoPath, ".codex-plugin", "marketplace.json")
   ];
   for (const mp of marketplacePaths) {
     if (await fileExists(mp)) {
@@ -86,7 +88,7 @@ async function discoverFromMarketplace(repoPath, marketplace) {
       skills = await discoverSkills(sourcePath);
     }
     let manifest = null;
-    for (const manifestDir of [".plugin", ".claude-plugin", ".cursor-plugin"]) {
+    for (const manifestDir of [".plugin", ".claude-plugin", ".cursor-plugin", ".codex-plugin"]) {
       const manifestPath = join(sourcePath, manifestDir, "plugin.json");
       if (await fileExists(manifestPath)) {
         manifest = await readJson(manifestPath);
@@ -127,6 +129,7 @@ async function isPluginDir(dirPath) {
     join(dirPath, ".plugin", "plugin.json"),
     join(dirPath, ".claude-plugin", "plugin.json"),
     join(dirPath, ".cursor-plugin", "plugin.json"),
+    join(dirPath, ".codex-plugin", "plugin.json"),
     join(dirPath, "skills"),
     join(dirPath, "commands"),
     join(dirPath, "agents"),
@@ -139,7 +142,7 @@ async function isPluginDir(dirPath) {
 }
 async function inspectPlugin(pluginPath) {
   let manifest = null;
-  for (const manifestDir of [".plugin", ".claude-plugin", ".cursor-plugin"]) {
+  for (const manifestDir of [".plugin", ".claude-plugin", ".cursor-plugin", ".codex-plugin"]) {
     const manifestPath = join(pluginPath, manifestDir, "plugin.json");
     if (await fileExists(manifestPath)) {
       manifest = await readJson(manifestPath);
@@ -331,6 +334,12 @@ var TARGET_DEFS = [
     name: "Cursor",
     description: "AI-powered code editor",
     configPath: join2(HOME, ".cursor")
+  },
+  {
+    id: "codex",
+    name: "Codex",
+    description: "OpenAI's coding agent",
+    configPath: join2(HOME, ".codex")
   }
   // Future targets can be added here:
   // {
@@ -353,7 +362,9 @@ function detectTarget(def) {
     case "claude-code":
       return detectBinary("claude");
     case "cursor":
-      return detectBinary("cursor") && detectBinary("claude");
+      return detectBinary("cursor");
+    case "codex":
+      return detectBinary("codex");
     default:
       return false;
   }
@@ -441,6 +452,13 @@ function barLine(content = "") {
 function barEmpty() {
   console.log(`${c.gray(S.bar)}`);
 }
+var _debug = false;
+function setDebug(enabled) {
+  _debug = enabled;
+}
+function barDebug(content = "") {
+  if (_debug) barLine(content);
+}
 function step(content) {
   console.log(`${c.gray(S.step)}  ${content}`);
 }
@@ -663,29 +681,21 @@ function banner() {
 }
 
 // lib/install.ts
-function installerKey(targetId) {
-  switch (targetId) {
-    case "claude-code":
-    case "cursor":
-      return "claude-code";
-    default:
-      return targetId;
-  }
-}
-var completedInstallers = /* @__PURE__ */ new Set();
+var cachePopulated = false;
 async function installPlugins(plugins, target, scope, repoPath, source) {
-  const key = installerKey(target.id);
-  if (completedInstallers.has(key)) {
-    return;
-  }
-  switch (key) {
+  switch (target.id) {
     case "claude-code":
       await installToClaudeCode(plugins, scope, repoPath, source);
       break;
+    case "cursor":
+      await installToCursor(plugins, scope, repoPath, source);
+      break;
+    case "codex":
+      await installToCodex(plugins, scope, repoPath, source);
+      break;
     default:
       throw new Error(`Unsupported target: ${target.id}`);
   }
-  completedInstallers.add(key);
 }
 async function installToClaudeCode(plugins, scope, repoPath, source) {
   const marketplaceName = plugins[0]?.marketplace ?? deriveMarketplaceName(source);
@@ -695,19 +705,19 @@ async function installToClaudeCode(plugins, scope, repoPath, source) {
   const marketplaceSource = isAnthropicSource(source) ? normalizeGitUrl(source) : repoPath;
   const claudePath = findClaude();
   step("Adding marketplace");
-  barLine(c.dim(`Binary: ${claudePath}`));
+  barDebug(c.dim(`Binary: ${claudePath}`));
   try {
     const version = execSync2(`${claudePath} --version`, { encoding: "utf-8", stdio: "pipe" }).trim();
-    barLine(c.dim(`Version: ${version}`));
+    barDebug(c.dim(`Version: ${version}`));
   } catch {
-    barLine(c.dim(`Warning: could not get claude version`));
+    barDebug(c.dim(`Warning: could not get claude version`));
   }
   try {
     const result = execSync2(`${claudePath} plugin marketplace add ${marketplaceSource}`, {
       encoding: "utf-8",
       stdio: "pipe"
     });
-    if (result.trim()) barLine(c.dim(result.trim()));
+    if (result.trim()) barDebug(c.dim(result.trim()));
     stepDone("Marketplace added");
   } catch (err) {
     const stderr = err.stderr?.toString().trim() ?? "";
@@ -747,6 +757,285 @@ async function installToClaudeCode(plugins, scope, repoPath, source) {
       }
     }
   }
+  cachePopulated = true;
+}
+async function installToCursor(plugins, scope, repoPath, source) {
+  if (cachePopulated) return;
+  const claudePath = findClaudeOrNull();
+  if (claudePath) {
+    await installToClaudeCode(plugins, scope, repoPath, source);
+    return;
+  }
+  await installToCursorExtensions(plugins, scope, repoPath, source);
+}
+async function installToPluginCache(plugins, scope, repoPath, source) {
+  const marketplaceName = plugins[0]?.marketplace ?? deriveMarketplaceName(source);
+  const home = homedir2();
+  const pluginsDir = join3(home, ".claude", "plugins");
+  const cacheDir = join3(pluginsDir, "cache");
+  step("Preparing plugins for Cursor...");
+  barEmpty();
+  await prepareForClaudeCode(plugins, repoPath, marketplaceName);
+  step("Registering marketplace");
+  await mkdir(pluginsDir, { recursive: true });
+  const knownPath = join3(pluginsDir, "known_marketplaces.json");
+  let knownMarketplaces = {};
+  if (existsSync2(knownPath)) {
+    try {
+      knownMarketplaces = JSON.parse(await readFile2(knownPath, "utf-8"));
+    } catch {
+    }
+  }
+  if (knownMarketplaces[marketplaceName]) {
+    stepDone(`Marketplace ${c.dim("'" + marketplaceName + "'")} already registered`);
+  } else {
+    knownMarketplaces[marketplaceName] = {
+      source: { source: "directory", path: repoPath },
+      installLocation: repoPath,
+      lastUpdated: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await writeFile(knownPath, JSON.stringify(knownMarketplaces, null, 2));
+    stepDone("Marketplace registered");
+  }
+  barEmpty();
+  const installedPath = join3(pluginsDir, "installed_plugins.json");
+  let installedData = { version: 2, plugins: {} };
+  if (existsSync2(installedPath)) {
+    try {
+      installedData = JSON.parse(await readFile2(installedPath, "utf-8"));
+    } catch {
+    }
+  }
+  let gitSha;
+  try {
+    gitSha = execSync2("git rev-parse HEAD", { cwd: repoPath, encoding: "utf-8", stdio: "pipe" }).trim();
+  } catch {
+  }
+  for (const plugin of plugins) {
+    const pluginRef = `${plugin.name}@${marketplaceName}`;
+    const version = plugin.version ?? "0.0.0";
+    step(`Installing ${c.bold(pluginRef)}...`);
+    const cacheDest = join3(cacheDir, marketplaceName, plugin.name, version);
+    await mkdir(cacheDest, { recursive: true });
+    await cp(plugin.path, cacheDest, { recursive: true });
+    barDebug(c.dim(`Cached to ${cacheDest}`));
+    const pluginKey = `${plugin.name}@${marketplaceName}`;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const entry = {
+      scope,
+      installPath: cacheDest,
+      version,
+      installedAt: now,
+      lastUpdated: now
+    };
+    if (gitSha) entry.gitCommitSha = gitSha;
+    installedData.plugins[pluginKey] = [entry];
+    stepDone(`Installed ${c.cyan(pluginRef)}`);
+  }
+  await writeFile(installedPath, JSON.stringify(installedData, null, 2));
+  barDebug(c.dim("Updated installed_plugins.json"));
+  cachePopulated = true;
+}
+async function installToCursorExtensions(plugins, scope, repoPath, source) {
+  if (process.platform !== "win32") {
+    await installToPluginCache(plugins, scope, repoPath, source);
+    return;
+  }
+  const marketplaceName = plugins[0]?.marketplace ?? deriveMarketplaceName(source);
+  const home = homedir2();
+  const extensionsDir = join3(home, ".cursor", "extensions");
+  step("Preparing plugins for Cursor...");
+  barEmpty();
+  await prepareForClaudeCode(plugins, repoPath, marketplaceName);
+  await mkdir(extensionsDir, { recursive: true });
+  const extensionsJsonPath = join3(extensionsDir, "extensions.json");
+  let extensions = [];
+  if (existsSync2(extensionsJsonPath)) {
+    try {
+      const parsed = JSON.parse(await readFile2(extensionsJsonPath, "utf-8"));
+      if (Array.isArray(parsed)) extensions = parsed;
+    } catch {
+    }
+  }
+  let gitSha;
+  try {
+    gitSha = execSync2("git rev-parse HEAD", { cwd: repoPath, encoding: "utf-8", stdio: "pipe" }).trim();
+  } catch {
+  }
+  for (const plugin of plugins) {
+    const pluginRef = `${plugin.name}@${marketplaceName}`;
+    const version = plugin.version ?? "0.0.0";
+    const folderName = `${marketplaceName}.${plugin.name}-${version}`;
+    const destDir = join3(extensionsDir, folderName);
+    step(`Installing ${c.bold(pluginRef)}...`);
+    await mkdir(destDir, { recursive: true });
+    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
+    );
+    const uriPath = "/" + destDir.replace(/\\/g, "/");
+    extensions.push({
+      identifier: { id: identifier },
+      version,
+      location: { $mid: 1, path: uriPath, scheme: "file" },
+      relativeLocation: folderName,
+      metadata: {
+        installedTimestamp: Date.now(),
+        ...gitSha ? { gitCommitSha: gitSha } : {}
+      }
+    });
+    stepDone(`Installed ${c.cyan(pluginRef)}`);
+  }
+  await writeFile(extensionsJsonPath, JSON.stringify(extensions, null, 2));
+  barDebug(c.dim("Updated extensions.json"));
+  cachePopulated = true;
+}
+async function installToCodex(plugins, scope, repoPath, source) {
+  const marketplaceName = plugins[0]?.marketplace ?? deriveMarketplaceName(source);
+  const home = homedir2();
+  const cacheDir = join3(home, ".codex", "plugins", "cache");
+  const configPath = join3(home, ".codex", "config.toml");
+  const marketplaceDir = join3(home, ".agents", "plugins");
+  const marketplacePath = join3(marketplaceDir, "marketplace.json");
+  const marketplaceRoot = home;
+  step("Preparing plugins for Codex...");
+  barEmpty();
+  for (const plugin of plugins) {
+    await preparePluginDirForVendor(plugin, ".codex-plugin", "CODEX_PLUGIN_ROOT");
+    await enrichForCodex(plugin);
+  }
+  let gitSha;
+  try {
+    gitSha = execSync2("git rev-parse HEAD", { cwd: repoPath, encoding: "utf-8", stdio: "pipe" }).trim();
+  } catch {
+  }
+  const versionKey = gitSha ?? "local";
+  const pluginPaths = {};
+  for (const plugin of plugins) {
+    const pluginRef = `${plugin.name}@${marketplaceName}`;
+    step(`Installing ${c.bold(pluginRef)}...`);
+    const cacheDest = join3(cacheDir, marketplaceName, plugin.name, versionKey);
+    await mkdir(cacheDest, { recursive: true });
+    await cp(plugin.path, cacheDest, { recursive: true });
+    pluginPaths[plugin.name] = cacheDest;
+    barDebug(c.dim(`Cached to ${cacheDest}`));
+    stepDone(`Installed ${c.cyan(pluginRef)}`);
+  }
+  step("Updating marketplace...");
+  await mkdir(marketplaceDir, { recursive: true });
+  let marketplace = {
+    name: "plugins-cli",
+    interface: { displayName: "Plugins CLI" },
+    plugins: []
+  };
+  if (existsSync2(marketplacePath)) {
+    try {
+      const existing = JSON.parse(await readFile2(marketplacePath, "utf-8"));
+      if (existing && typeof existing === "object" && Array.isArray(existing.plugins)) {
+        marketplace = existing;
+      }
+    } catch {
+    }
+  }
+  for (const plugin of plugins) {
+    const cacheDest = pluginPaths[plugin.name];
+    const relPath = relative(marketplaceRoot, cacheDest);
+    marketplace.plugins = marketplace.plugins.filter(
+      (e) => e.name !== plugin.name
+    );
+    marketplace.plugins.push({
+      name: plugin.name,
+      source: {
+        source: "local",
+        path: `./${relPath}`
+      },
+      policy: {
+        installation: "AVAILABLE",
+        authentication: "ON_INSTALL"
+      },
+      category: "Coding"
+    });
+  }
+  await writeFile(marketplacePath, JSON.stringify(marketplace, null, 2));
+  stepDone("Marketplace updated");
+  step("Updating config.toml...");
+  await mkdir(join3(home, ".codex"), { recursive: true });
+  let configContent = "";
+  if (existsSync2(configPath)) {
+    configContent = await readFile2(configPath, "utf-8");
+  }
+  let configChanged = false;
+  for (const plugin of plugins) {
+    const pluginKey = `${plugin.name}@plugins-cli`;
+    const tomlSection = `[plugins."${pluginKey}"]`;
+    if (configContent.includes(tomlSection)) {
+      barDebug(c.dim(`${pluginKey} already in config.toml`));
+      continue;
+    }
+    const entry = `
+${tomlSection}
+enabled = true
+`;
+    configContent += entry;
+    configChanged = true;
+    barDebug(c.dim(`Added ${pluginKey} to config.toml`));
+  }
+  if (configChanged) {
+    await writeFile(configPath, configContent);
+  }
+  stepDone("Config updated");
+}
+async function enrichForCodex(plugin) {
+  const codexManifestPath = join3(plugin.path, ".codex-plugin", "plugin.json");
+  if (!existsSync2(codexManifestPath)) return;
+  let manifest;
+  try {
+    manifest = JSON.parse(await readFile2(codexManifestPath, "utf-8"));
+  } catch {
+    return;
+  }
+  if (manifest.interface) return;
+  let changed = false;
+  if (!manifest.skills && existsSync2(join3(plugin.path, "skills"))) {
+    manifest.skills = "./skills/";
+    changed = true;
+  }
+  if (!manifest.mcpServers && existsSync2(join3(plugin.path, ".mcp.json"))) {
+    manifest.mcpServers = "./.mcp.json";
+    changed = true;
+  }
+  if (!manifest.apps && existsSync2(join3(plugin.path, ".app.json"))) {
+    manifest.apps = "./.app.json";
+    changed = true;
+  }
+  const name = manifest.name ?? plugin.name;
+  const description = manifest.description ?? plugin.description ?? "";
+  const author = manifest.author;
+  const iface = {
+    displayName: name.charAt(0).toUpperCase() + name.slice(1),
+    shortDescription: description,
+    developerName: author?.name ?? "Unknown",
+    category: "Coding",
+    capabilities: ["Interactive", "Write"]
+  };
+  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"];
+  for (const candidate of assetCandidates) {
+    if (existsSync2(join3(plugin.path, candidate))) {
+      iface.logo = `./${candidate}`;
+      iface.composerIcon = `./${candidate}`;
+      break;
+    }
+  }
+  manifest.interface = iface;
+  changed = true;
+  if (changed) {
+    await writeFile(codexManifestPath, JSON.stringify(manifest, null, 2));
+    barDebug(c.dim(`${plugin.name}: enriched .codex-plugin/plugin.json for Codex`));
+  }
 }
 async function prepareForClaudeCode(plugins, repoPath, marketplaceName) {
   const claudePluginDir = join3(repoPath, ".claude-plugin");
@@ -773,12 +1062,12 @@ async function prepareForClaudeCode(plugins, repoPath, marketplaceName) {
     join3(claudePluginDir, "marketplace.json"),
     JSON.stringify(marketplaceJson, null, 2)
   );
-  barLine(c.dim("Generated .claude-plugin/marketplace.json"));
+  barDebug(c.dim("Generated .claude-plugin/marketplace.json"));
   for (const plugin of plugins) {
     await preparePluginDirForVendor(plugin, ".claude-plugin", "CLAUDE_PLUGIN_ROOT");
   }
 }
-function findClaude() {
+function findClaudeOrNull() {
   try {
     const path = execSync2("which claude", { encoding: "utf-8", stdio: "pipe" }).trim();
     if (path) return path;
@@ -793,7 +1082,10 @@ function findClaude() {
   for (const candidate of candidates) {
     if (existsSync2(candidate)) return candidate;
   }
-  return "claude";
+  return null;
+}
+function findClaude() {
+  return findClaudeOrNull() ?? "claude";
 }
 async function preparePluginDirForVendor(plugin, vendorDir, envVar) {
   const pluginPath = plugin.path;
@@ -803,7 +1095,7 @@ async function preparePluginDirForVendor(plugin, vendorDir, envVar) {
   const hasVendorPlugin = existsSync2(join3(vendorPluginDir, "plugin.json"));
   if (hasOpenPlugin && !hasVendorPlugin) {
     await cp(openPluginDir, vendorPluginDir, { recursive: true });
-    barLine(c.dim(`${plugin.name}: translated .plugin/ \u2192 ${vendorDir}/`));
+    barDebug(c.dim(`${plugin.name}: translated .plugin/ \u2192 ${vendorDir}/`));
   }
   if (!hasOpenPlugin && !hasVendorPlugin) {
     await mkdir(vendorPluginDir, { recursive: true });
@@ -819,14 +1111,15 @@ async function preparePluginDirForVendor(plugin, vendorDir, envVar) {
         2
       )
     );
-    barLine(c.dim(`${plugin.name}: generated ${vendorDir}/plugin.json`));
+    barDebug(c.dim(`${plugin.name}: generated ${vendorDir}/plugin.json`));
   }
   await translateEnvVars(pluginPath, plugin.name, envVar);
 }
 var KNOWN_PLUGIN_ROOT_VARS = [
   "PLUGIN_ROOT",
   "CLAUDE_PLUGIN_ROOT",
-  "CURSOR_PLUGIN_ROOT"
+  "CURSOR_PLUGIN_ROOT",
+  "CODEX_PLUGIN_ROOT"
 ];
 async function translateEnvVars(pluginPath, pluginName, envVar) {
   const configFiles = [
@@ -848,7 +1141,7 @@ async function translateEnvVars(pluginPath, pluginName, envVar) {
     }
     if (changed) {
       await writeFile(filePath, content);
-      barLine(
+      barDebug(
         c.dim(`${pluginName}: translated plugin root \u2192 \${${envVar}} in ${filePath.split("/").pop()}`)
       );
     }
@@ -935,12 +1228,14 @@ var { values, positionals } = parseArgs({
     target: { type: "string", short: "t" },
     scope: { type: "string", short: "s", default: "user" },
     yes: { type: "boolean", short: "y" },
-    remote: { type: "boolean" }
+    remote: { type: "boolean" },
+    debug: { type: "boolean" }
   },
   allowPositionals: true,
   strict: true
 });
 var [command, ...rest] = positionals;
+if (values.debug) setDebug(true);
 if (values.help || !command) {
   printUsage();
   process.exit(0);
@@ -973,6 +1268,7 @@ ${c.dim("Options:")}
   ${c.yellow("-s, --scope")} <scope>     Install scope: user, project, local. Default: user
   ${c.yellow("-y, --yes")}               Skip confirmation prompts
   ${c.yellow("--remote")}                Include remote-source plugins in output
+  ${c.yellow("--debug")}                 Show verbose installation output
   ${c.yellow("-h, --help")}              Show this help
 `);
 }
@@ -1070,11 +1366,16 @@ async function cmdInstall(source, opts) {
       footer();
       process.exit(1);
     }
+    if (!found.detected) {
+      barEmpty();
+      barLine(c.yellow(`Warning: ${found.name} was not detected on this system.`));
+    }
     installTargets = [found];
   } else if (detectedTargets.length === 0) {
     barEmpty();
     stepError("No supported targets detected.");
-    barLine(c.dim("Use --target to specify one."));
+    barLine(c.dim("Neither 'claude', 'cursor', nor 'codex' binaries were found on PATH."));
+    barLine(c.dim("Use --target to specify one manually."));
     footer();
     process.exit(1);
   } else {
@@ -1203,7 +1504,7 @@ function sshToHttps(sshUrl) {
 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");
+    const cacheDir = join4(homedir3(), ".cache", "plugins");
     mkdirSync(cacheDir, { recursive: true });
     const slug = url.replace(/^https?:\/\//, "").replace(/^git@/, "").replace(/\.git$/, "").replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
     const tmpDir = join4(cacheDir, slug);
@@ -1213,7 +1514,7 @@ function resolveSource(source) {
     step(`Source: ${c.dim(url)}`);
     barEmpty();
     try {
-      execSync3(`git clone --depth 1 -q ${url} ${tmpDir}`, { stdio: "pipe" });
+      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")) {
@@ -1223,7 +1524,7 @@ function resolveSource(source) {
           step(`Source: ${c.dim(httpsUrl)}`);
           barEmpty();
           try {
-            execSync3(`git clone --depth 1 -q ${httpsUrl} ${tmpDir}`, { stdio: "inherit" });
+            execSync3(`git clone --depth 1 -q "${httpsUrl}" "${tmpDir}"`, { stdio: "inherit" });
             stepDone("Repository cloned");
             barEmpty();
             return tmpDir;

package/package.json

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