a11y-devkit-deploy 0.6.2 → 0.6.4

package/config/a11y.json

@@ -15,6 +15,12 @@
     "vscode": ".github/skills",
     "local": ".github/skills"
   },
+  "ideMcpPaths": {
+    "claude": ".claude/mcp.json",
+    "cursor": ".cursor/mcp.json",
+    "codex": ".codex/mcp.json",
+    "vscode": ".github/mcp.json"
+  },
   "mcpServers": [
     {
       "name": "wcag",

package/package.json

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

package/src/cli.js

@@ -61,7 +61,7 @@ async function run() {
   const platformInfo = getPlatform();
   const config = await loadConfig();
   const pkg = await loadPackageJson();
-  const idePaths = getIdePaths(projectRoot, platformInfo, config.ideSkillsPaths);
+  const idePaths = getIdePaths(projectRoot, platformInfo, config.ideSkillsPaths, config.ideMcpPaths);
   const args = parseArgs(process.argv);
 
   header(`A11y Devkit Deploy v${pkg.version}`, "Install skills + MCP servers across IDEs");
@@ -70,13 +70,13 @@ async function run() {
   console.log("\nSkills to install:");
   config.skills.forEach((skill) => {
     const description = skillDescriptions[skill] || "No description";
-    info(`  ${skill} - ${description}`);
+    console.log(`${skill} - ${description}`);
   });
 
   console.log("\nMCP Servers to install:");
   config.mcpServers.forEach((server) => {
     const description = mcpDescriptions[server.name] || "No description";
-    info(`  ${server.name} - ${description}`);
+    console.log(`${server.name} - ${description}`);
   });
   console.log("");
 
@@ -88,6 +88,7 @@ async function run() {
   ];
 
   let scope = args.scope;
+  let mcpScope = null;
   let ideSelection = ["claude", "cursor", "codex", "vscode"];
   let installSkills = true;
 
@@ -99,11 +100,29 @@ async function run() {
           name: "scope",
           message: "Install skills + repo locally or globally?",
           choices: [
-            { title: "Local to this project", value: "local" },
+            { title: `Local to this project (${formatPath(projectRoot)})`, value: "local" },
             { title: "Global for this user", value: "global" }
           ],
           initial: 0
         },
+        {
+          type: "select",
+          name: "mcpScope",
+          message: "Install MCP configs locally or globally?",
+          choices: [
+            {
+              title: `Local to this project (${formatPath(projectRoot)})`,
+              value: "local",
+              description: "Write to project-level IDE config folders (version-controllable)"
+            },
+            {
+              title: "Global for this user",
+              value: "global",
+              description: "Write to user-level IDE config folders"
+            }
+          ],
+          initial: 0
+        },
         {
           type: "multiselect",
           name: "ides",
@@ -129,6 +148,7 @@ async function run() {
     );
 
     scope = scope || response.scope;
+    mcpScope = response.mcpScope || "local";
     ideSelection = response.ides || ideSelection;
     installSkills = response.installSkills;
   }
@@ -136,13 +156,17 @@ async function run() {
   if (!scope) {
     scope = "local";
   }
+  if (!mcpScope) {
+    mcpScope = "local";
+  }
 
   if (!ideSelection.length) {
     warn("No IDEs selected. MCP installation requires at least one IDE.");
     process.exit(1);
   }
 
-  info(`Install scope: ${scope === "local" ? "Local" : "Global"}`);
+  info(`Skills scope: ${scope === "local" ? "Local" : "Global"}`);
+  info(`MCP scope: ${mcpScope === "local" ? "Local" : "Global"}`);
 
   // Create temp directory for npm install
   const tempDir = path.join(getTempDir(), `.a11y-devkit-${Date.now()}`);
@@ -166,10 +190,19 @@ async function run() {
 
   // Configure MCP servers using npx (no local installation needed!)
   const mcpSpinner = startSpinner("Updating MCP configurations...");
-  for (const ide of ideSelection) {
-    await installMcpConfig(idePaths[ide].mcpConfig, config.mcpServers, idePaths[ide].mcpServerKey);
+  const mcpConfigPaths = mcpScope === "local"
+    ? ideSelection.map((ide) => idePaths[ide].localMcpConfig)
+    : ideSelection.map((ide) => idePaths[ide].mcpConfig);
+
+  for (let i = 0; i < ideSelection.length; i++) {
+    const ide = ideSelection[i];
+    await installMcpConfig(
+      mcpConfigPaths[i],
+      config.mcpServers,
+      idePaths[ide].mcpServerKey
+    );
   }
-  mcpSpinner.succeed(`MCP configs updated for ${ideSelection.length} IDE(s).`);
+  mcpSpinner.succeed(`MCP configs updated for ${ideSelection.length} IDE(s) (${mcpScope} scope).`);
 
   // Clean up temporary directory
   const cleanupSpinner = startSpinner("Cleaning up temporary files...");

package/src/paths.js

@@ -30,7 +30,7 @@ function getAppSupportDir(platformInfo = getPlatform()) {
   return process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
 }
 
-function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths = null) {
+function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths = null, ideMcpPaths = null) {
   const appSupport = getAppSupportDir(platformInfo);
   const home = os.homedir();
 
@@ -43,10 +43,18 @@ function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths =
     local: ".github/skills"
   };
 
+  const mcpPaths = ideMcpPaths || {
+    claude: ".claude/mcp.json",
+    cursor: ".cursor/mcp.json",
+    codex: ".codex/mcp.json",
+    vscode: ".vscode/mcp.json"
+  };
+
   return {
     claude: {
       name: "Claude Code",
       mcpConfig: path.join(appSupport, "Claude", "mcp.json"),
+      localMcpConfig: path.join(projectRoot, mcpPaths.claude),
       mcpServerKey: "servers",
       skillsDir: path.join(home, skillsPaths.claude),
       localSkillsDir: path.join(projectRoot, skillsPaths.claude)
@@ -54,6 +62,7 @@ function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths =
     cursor: {
       name: "Cursor",
       mcpConfig: path.join(appSupport, "Cursor", "mcp.json"),
+      localMcpConfig: path.join(projectRoot, mcpPaths.cursor),
       mcpServerKey: "mcpServers",
       skillsDir: path.join(home, skillsPaths.cursor),
       localSkillsDir: path.join(projectRoot, skillsPaths.cursor)
@@ -61,6 +70,7 @@ function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths =
     codex: {
       name: "Codex",
       mcpConfig: path.join(home, ".codex", "mcp.json"),
+      localMcpConfig: path.join(projectRoot, mcpPaths.codex),
       mcpServerKey: "servers",
       skillsDir: path.join(home, skillsPaths.codex),
       localSkillsDir: path.join(projectRoot, skillsPaths.codex)
@@ -68,6 +78,7 @@ function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths =
     vscode: {
       name: "VSCode",
       mcpConfig: path.join(appSupport, "Code", "User", "mcp.json"),
+      localMcpConfig: path.join(projectRoot, mcpPaths.vscode),
       mcpServerKey: "servers",
       skillsDir: path.join(home, skillsPaths.vscode),
       localSkillsDir: path.join(projectRoot, skillsPaths.vscode)