plugins 1.2.5 → 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:
   // {
@@ -354,6 +363,8 @@ function detectTarget(def) {
       return detectBinary("claude");
     case "cursor":
       return detectBinary("cursor");
+    case "codex":
+      return detectBinary("codex");
     default:
       return false;
   }
@@ -679,6 +690,9 @@ async function installPlugins(plugins, target, scope, repoPath, source) {
     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}`);
   }
@@ -752,7 +766,7 @@ async function installToCursor(plugins, scope, repoPath, source) {
     await installToClaudeCode(plugins, scope, repoPath, source);
     return;
   }
-  await installToPluginCache(plugins, scope, repoPath, source);
+  await installToCursorExtensions(plugins, scope, repoPath, source);
 }
 async function installToPluginCache(plugins, scope, repoPath, source) {
   const marketplaceName = plugins[0]?.marketplace ?? deriveMarketplaceName(source);
@@ -822,6 +836,207 @@ async function installToPluginCache(plugins, scope, repoPath, source) {
   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");
   await mkdir(claudePluginDir, { recursive: true });
@@ -903,7 +1118,8 @@ async function preparePluginDirForVendor(plugin, vendorDir, 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 = [
@@ -1158,7 +1374,7 @@ async function cmdInstall(source, opts) {
   } else if (detectedTargets.length === 0) {
     barEmpty();
     stepError("No supported targets detected.");
-    barLine(c.dim("Neither 'claude' nor 'cursor' binaries were found on PATH."));
+    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);
@@ -1288,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);
@@ -1298,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")) {
@@ -1308,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.5",
+  "version": "1.2.7",
   "description": "Install open-plugin format plugins into agent tools",
   "type": "module",
   "bin": {