plugins 1.2.5 → 1.2.9

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;
   }
@@ -369,10 +380,11 @@ function detectBinary(name) {
 
 // lib/install.ts
 import { join as join3, relative } from "path";
-import { mkdir, cp, readFile as readFile2, writeFile } from "fs/promises";
+import { mkdir, cp, readFile as readFile2, writeFile, rm } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
 import { execSync as execSync2 } from "child_process";
 import { homedir as homedir2 } from "os";
+import { createHash } from "crypto";
 
 // lib/ui.ts
 var isColorSupported = process.env.FORCE_COLOR !== "0" && !process.env.NO_COLOR && (process.env.FORCE_COLOR !== void 0 || process.stdout.isTTY);
@@ -673,16 +685,45 @@ function banner() {
 var cachePopulated = false;
 async function installPlugins(plugins, target, scope, repoPath, source) {
   switch (target.id) {
-    case "claude-code":
-      await installToClaudeCode(plugins, scope, repoPath, source);
+    case "claude-code": {
+      const workspace = await stageInstallWorkspace(plugins, repoPath, target.id);
+      await installToClaudeCode(workspace.plugins, scope, workspace.repoPath, source);
       break;
-    case "cursor":
-      await installToCursor(plugins, scope, repoPath, source);
+    }
+    case "cursor": {
+      if (cachePopulated) return;
+      const workspace = await stageInstallWorkspace(plugins, repoPath, target.id);
+      await installToCursor(workspace.plugins, scope, workspace.repoPath, source);
+      break;
+    }
+    case "codex": {
+      const workspace = await stageInstallWorkspace(plugins, repoPath, target.id);
+      await installToCodex(workspace.plugins, scope, workspace.repoPath, source);
       break;
+    }
     default:
       throw new Error(`Unsupported target: ${target.id}`);
   }
 }
+async function stageInstallWorkspace(plugins, repoPath, targetId, stagingBaseDir = join3(homedir2(), ".cache", "plugins", ".install-staging")) {
+  const stageKey = createHash("sha1").update(repoPath).digest("hex");
+  const stageRoot = join3(stagingBaseDir, stageKey, targetId);
+  const stagedRepoPath = join3(stageRoot, "repo");
+  await mkdir(stageRoot, { recursive: true });
+  await rm(stagedRepoPath, { recursive: true, force: true });
+  await cp(repoPath, stagedRepoPath, { recursive: true });
+  const stagedPlugins = plugins.map((plugin) => {
+    const relPath = relative(repoPath, plugin.path);
+    return {
+      ...plugin,
+      path: relPath === "" ? stagedRepoPath : join3(stagedRepoPath, relPath)
+    };
+  });
+  return {
+    repoPath: stagedRepoPath,
+    plugins: stagedPlugins
+  };
+}
 async function installToClaudeCode(plugins, scope, repoPath, source) {
   const marketplaceName = plugins[0]?.marketplace ?? deriveMarketplaceName(source);
   step("Preparing plugins for Claude Code...");
@@ -752,7 +793,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 +863,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 +1145,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 = [
@@ -1004,7 +1247,7 @@ function track(data) {
 }
 
 // index.ts
-setVersion("1.0.1");
+setVersion("1.2.8");
 var { values, positionals } = parseArgs({
   args: process.argv.slice(2),
   options: {
@@ -1158,7 +1401,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 +1531,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 +1541,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 +1551,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.9",
   "description": "Install open-plugin format plugins into agent tools",
   "type": "module",
   "bin": {
@@ -11,9 +11,11 @@
   ],
   "scripts": {
     "build": "tsup",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "test": "tsx --test test/*.test.ts"
   },
   "devDependencies": {
+    "tsx": "^4.20.6",
     "tsup": "^8",
     "typescript": "^5"
   }