a11y-devkit-deploy 0.9.6 → 0.9.8

package/config/settings.json

@@ -51,13 +51,15 @@
       "id": "claude",
       "displayName": "Claude Code",
       "mcpServerKey": "servers",
+      "globalMcpServerKey": "mcpServers",
       "skillsFolder": ".claude/skills",
-      "mcpConfigFile": ".claude/mcp.json"
+      "mcpConfigFile": ".claude.json"
     },
     {
       "id": "cursor",
       "displayName": "Cursor",
       "mcpServerKey": "mcpServers",
+      "globalMcpServerKey": "mcpServers",
       "skillsFolder": ".cursor/skills",
       "mcpConfigFile": ".cursor/mcp.json"
     },
@@ -65,6 +67,7 @@
       "id": "codex",
       "displayName": "Codex",
       "mcpServerKey": "mcp_servers",
+      "globalMcpServerKey": "mcp_servers",
       "skillsFolder": ".codex/skills",
       "mcpConfigFile": ".codex/config.toml"
     },
@@ -72,6 +75,7 @@
       "id": "vscode",
       "displayName": "VSCode",
       "mcpServerKey": "servers",
+      "globalMcpServerKey": "servers",
       "skillsFolder": ".github/skills",
       "mcpConfigFile": ".github/mcp.json",
       "globalMcpConfigFile": "Code/User/mcp.json"
@@ -80,6 +84,7 @@
       "id": "windsurf",
       "displayName": "Windsurf",
       "mcpServerKey": "servers",
+      "globalMcpServerKey": "servers",
       "skillsFolder": ".codeium/windsurf/skills",
       "mcpConfigFile": ".codeium/windsurf/mcp_config.json"
     },
@@ -87,6 +92,7 @@
       "id": "factory",
       "displayName": "Factory",
       "mcpServerKey": "mcpServers",
+      "globalMcpServerKey": "mcpServers",
       "skillsFolder": ".factory/skills",
       "mcpConfigFile": ".factory/mcp.json"
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "a11y-devkit-deploy",
-  "version": "0.9.6",
+  "version": "0.9.8",
   "description": "CLI to deploy a11y skills and MCP servers across IDEs",
   "license": "MIT",
   "type": "module",

package/src/cli.js

@@ -8,7 +8,7 @@ import kleur from "kleur";
 // Use gray with italics (ANSI 90 for gray, 3 for italic, 23 to reset italic)
 // This matches the subtitle color but with italic styling
 const grayItalic = (text) => {
-  if (typeof text === 'string') {
+  if (typeof text === "string") {
     return `\x1b[3m\x1b[90m${text}\x1b[39m\x1b[23m`;
   }
   // Return a function that applies both italic and gray
@@ -16,16 +16,27 @@ const grayItalic = (text) => {
 };
 
 // Replace gray with italic gray for helper text
-Object.defineProperty(kleur, 'gray', {
-  get() { return grayItalic; },
-  configurable: true
+Object.defineProperty(kleur, "gray", {
+  get() {
+    return grayItalic;
+  },
+  configurable: true,
 });
 
 import prompts from "prompts";
 
 import { header, info, warn, success, startSpinner, formatPath } from "./ui.js";
-import { getPlatform, getHostApplicationPaths, getTempDir, getMcpRepoDir } from "./paths.js";
-import { installSkillsFromNpm, uninstallSkillsFromTargets, cleanupTemp } from "./installers/skills.js";
+import {
+  getPlatform,
+  getHostApplicationPaths,
+  getTempDir,
+  getMcpRepoDir,
+} from "./paths.js";
+import {
+  installSkillsFromNpm,
+  uninstallSkillsFromTargets,
+  cleanupTemp,
+} from "./installers/skills.js";
 import { installMcpConfig, removeMcpConfig } from "./installers/mcp.js";
 import { getGitMcpPrompts, parseArgsString } from "./prompts/git-mcp.js";
 import { installGitMcp } from "./installers/git-mcp.js";
@@ -74,7 +85,11 @@ async function run() {
   const platformInfo = getPlatform();
   const config = await loadConfig();
   const pkg = await loadPackageJson();
-  const hostPaths = getHostApplicationPaths(projectRoot, platformInfo, config.hostApplications);
+  const hostPaths = getHostApplicationPaths(
+    projectRoot,
+    platformInfo,
+    config.hostApplications,
+  );
   const args = parseArgs(process.argv);
 
   header(
@@ -99,7 +114,13 @@ async function run() {
 
   // Branch to Git MCP installation flow
   if (args.gitMcp) {
-    await runGitMcpInstallation(projectRoot, platformInfo, config, hostPaths, args);
+    await runGitMcpInstallation(
+      projectRoot,
+      platformInfo,
+      config,
+      hostPaths,
+      args,
+    );
     return;
   }
 
@@ -132,12 +153,15 @@ async function run() {
         },
       );
 
-      selectedProfile = config.profiles.find((p) => p.id === profileResponse.profile);
+      selectedProfile = config.profiles.find(
+        (p) => p.id === profileResponse.profile,
+      );
 
       if (selectedProfile) {
         // Filter skills based on profile
         skillsToInstall = config.skills.filter((skill) => {
-          const skillNpmName = typeof skill === "string" ? skill : skill.npmName;
+          const skillNpmName =
+            typeof skill === "string" ? skill : skill.npmName;
           return selectedProfile.skills.includes(skillNpmName);
         });
 
@@ -168,7 +192,7 @@ async function run() {
         console.log(`    ${description}`);
       });
 
-      console.log("\nMCP Servers to install:");
+      console.log("\nMCP Servers to install: [will install globally]");
       mcpServersToInstall.forEach((server) => {
         const description = server.description || "No description";
         console.log(`  • ${server.name}`);
@@ -240,7 +264,8 @@ async function run() {
             {
               title: "Global for this user",
               value: "global",
-              description: "Write to user-level host application config folders",
+              description:
+                "Write to user-level host application config folders",
             },
           ],
           initial: 0,
@@ -262,7 +287,9 @@ async function run() {
     );
 
     scope = scope || response.scope;
-    mcpScope = response.mcpScope || (config.supportLocalMcpInstallation ? "local" : "global");
+    mcpScope =
+      response.mcpScope ||
+      (config.supportLocalMcpInstallation ? "local" : "global");
     hostSelection = response.hosts || hostSelection;
   }
 
@@ -274,7 +301,9 @@ async function run() {
   }
 
   if (!hostSelection.length) {
-    warn("No host applications selected. MCP installation requires at least one host application.");
+    warn(
+      "No host applications selected. MCP installation requires at least one host application.",
+    );
     process.exit(1);
   }
 
@@ -318,10 +347,14 @@ async function run() {
 
   for (let i = 0; i < hostSelection.length; i++) {
     const host = hostSelection[i];
+    const serverKey = mcpScope === "global"
+      ? hostPaths[host].globalMcpServerKey
+      : hostPaths[host].mcpServerKey;
     await installMcpConfig(
       mcpConfigPaths[i],
       mcpServersToInstall,
-      hostPaths[host].mcpServerKey,
+      serverKey,
+      platformInfo,
     );
   }
   mcpSpinner.succeed(
@@ -353,7 +386,13 @@ async function run() {
   info("Documentation: https://github.com/joe-watkins/a11y-devkit#readme");
 }
 
-async function runUninstall(projectRoot, platformInfo, config, hostPaths, args) {
+async function runUninstall(
+  projectRoot,
+  platformInfo,
+  config,
+  hostPaths,
+  args,
+) {
   console.log("\n");
   info("Removing skills and MCP servers installed by this tool");
   console.log("");
@@ -433,7 +472,8 @@ async function runUninstall(projectRoot, platformInfo, config, hostPaths, args)
           {
             title: "Global for this user",
             value: "global",
-            description: "Remove from user-level host application config folders",
+            description:
+              "Remove from user-level host application config folders",
           },
         ],
         initial: 0,
@@ -469,7 +509,9 @@ async function runUninstall(projectRoot, platformInfo, config, hostPaths, args)
   }
 
   if (!hostSelection.length) {
-    warn("No host applications selected. Uninstall requires at least one host application.");
+    warn(
+      "No host applications selected. Uninstall requires at least one host application.",
+    );
     process.exit(1);
   }
 
@@ -518,10 +560,13 @@ async function runUninstall(projectRoot, platformInfo, config, hostPaths, args)
 
     for (let i = 0; i < hostSelection.length; i++) {
       const host = hostSelection[i];
+      const serverKey = mcpScope === "global"
+        ? hostPaths[host].globalMcpServerKey
+        : hostPaths[host].mcpServerKey;
       const result = await removeMcpConfig(
         mcpConfigPaths[i],
         serverNames,
-        hostPaths[host].mcpServerKey,
+        serverKey,
       );
       removedCount += result.removed;
     }
@@ -538,7 +583,13 @@ async function runUninstall(projectRoot, platformInfo, config, hostPaths, args)
   success("Uninstall complete.");
 }
 
-async function runGitMcpInstallation(projectRoot, platformInfo, config, hostPaths, args) {
+async function runGitMcpInstallation(
+  projectRoot,
+  platformInfo,
+  config,
+  hostPaths,
+  args,
+) {
   // Check if --yes flag is used with --git-mcp
   if (args.autoYes) {
     warn("--yes flag not supported for Git MCP installation");
@@ -592,7 +643,9 @@ async function runGitMcpInstallation(projectRoot, platformInfo, config, hostPath
 
   // Prompt for MCP Config Scope (where to write MCP configurations)
   // Skip if local MCP installation is not supported
-  let mcpScopeResponse = { mcpScope: config.supportLocalMcpInstallation ? null : "global" };
+  let mcpScopeResponse = {
+    mcpScope: config.supportLocalMcpInstallation ? null : "global",
+  };
 
   if (config.supportLocalMcpInstallation) {
     mcpScopeResponse = await prompts(
@@ -648,7 +701,9 @@ async function runGitMcpInstallation(projectRoot, platformInfo, config, hostPath
   const hostSelection = hostResponse.hosts || [];
 
   if (!hostSelection.length) {
-    warn("No host applications selected. MCP installation requires at least one host application.");
+    warn(
+      "No host applications selected. MCP installation requires at least one host application.",
+    );
     process.exit(1);
   }
 
@@ -715,10 +770,14 @@ async function runGitMcpInstallation(projectRoot, platformInfo, config, hostPath
 
   for (let i = 0; i < hostSelection.length; i++) {
     const host = hostSelection[i];
+    const serverKey = mcpScope === "global"
+      ? hostPaths[host].globalMcpServerKey
+      : hostPaths[host].mcpServerKey;
     await installMcpConfig(
       mcpConfigPaths[i],
       [mcpServerConfig],
-      hostPaths[host].mcpServerKey,
+      serverKey,
+      platformInfo,
     );
   }
 
@@ -729,7 +788,9 @@ async function runGitMcpInstallation(projectRoot, platformInfo, config, hostPath
   // Display success message
   success("Git MCP installation complete!");
   info(`Repository location: ${mcpServer.repoPath}`);
-  info(`MCP server '${mcpServer.name}' configured in ${hostSelection.length} host application(s)`);
+  info(
+    `MCP server '${mcpServer.name}' configured in ${hostSelection.length} host application(s)`,
+  );
   console.log("");
   success("Next Steps:");
   info("Restart your host application to load the new MCP server");
@@ -738,4 +799,3 @@ async function runGitMcpInstallation(projectRoot, platformInfo, config, hostPath
 }
 
 export { run };
-

package/src/installers/mcp.js

@@ -143,7 +143,7 @@ async function loadConfig(filePath) {
   return isTomlFile(filePath) ? loadToml(filePath) : loadJson(filePath);
 }
 
-function mergeServers(existing, incoming, serverKey = "servers") {
+function mergeServers(existing, incoming, serverKey = "servers", platformInfo = null) {
   const existingServers = existing[serverKey] && typeof existing[serverKey] === "object"
     ? existing[serverKey]
     : {};
@@ -151,9 +151,18 @@ function mergeServers(existing, incoming, serverKey = "servers") {
   const merged = { ...existing, [serverKey]: { ...existingServers } };
 
   for (const server of incoming) {
+    let command = server.command;
+    let args = server.args || [];
+
+    // On Windows, wrap npx commands with cmd /c
+    if (platformInfo?.isWindows && command === "npx") {
+      command = "cmd";
+      args = ["/c", "npx", ...args];
+    }
+
     const serverConfig = {
-      command: server.command,
-      args: server.args || [],
+      command,
+      args,
       startup_timeout_sec: 30
     };
 
@@ -201,10 +210,10 @@ function removeServers(existing, removeNames, serverKey = "servers") {
   return { updated, removed };
 }
 
-async function installMcpConfig(configPath, servers, serverKey = "servers") {
+async function installMcpConfig(configPath, servers, serverKey = "servers", platformInfo = null) {
   await fs.mkdir(path.dirname(configPath), { recursive: true });
   const existing = await loadConfig(configPath);
-  const updated = mergeServers(existing, servers, serverKey);
+  const updated = mergeServers(existing, servers, serverKey, platformInfo);
 
   if (isTomlFile(configPath)) {
     await fs.writeFile(configPath, stringifySimpleToml(updated), "utf8");

package/src/paths.js

@@ -57,6 +57,7 @@ function getHostApplicationPaths(projectRoot, platformInfo = getPlatform(), host
       mcpConfig: globalMcpConfig,
       localMcpConfig: path.join(projectRoot, mcpConfigFile),
       mcpServerKey: host.mcpServerKey,
+      globalMcpServerKey: host.globalMcpServerKey || host.mcpServerKey,
       skillsDir: globalSkillsDir,
       localSkillsDir: path.join(projectRoot, skillsFolder)
     };