a11y-devkit-deploy 0.8.2 → 0.8.4

package/README.md

@@ -186,13 +186,13 @@ Add an object to the `mcpServers` array with name, description, command, and arg
 }
 ```
 
-### Adding a New IDE
+### Adding a New Host Application
 
-Add an object to the `ides` array with the IDE's configuration:
+Add an object to the `hostApplications` array with the host application's configuration:
 
 ```json
 {
-  "ides": [
+  "hostApplications": [
     {
       "id": "windsurf",
       "displayName": "Windsurf",
@@ -204,8 +204,8 @@ Add an object to the `ides` array with the IDE's configuration:
 }
 ```
 
-**IDE Configuration Properties:**
-- `id` - Unique identifier for the IDE
+**Host Application Configuration Properties:**
+- `id` - Unique identifier for the host application
 - `displayName` - Human-readable name shown in prompts
 - `mcpServerKey` - MCP config key name (`"servers"` or `"mcpServers"`)
 - `skillsFolder` - Path to skills directory (relative to home/project root)
@@ -216,7 +216,7 @@ Add an object to the `ides` array with the IDE's configuration:
 - `skillsFolder` - Subfolder name to bundle skills under (e.g., "a11y")
 - `readmeTemplate` - README template file to copy into skills directories
 - `skills` - Array of skill objects with `name` (npm package) and `description`
-- `ides` - Array of IDE configuration objects
+- `hostApplications` - Array of host application configuration objects
 - `mcpServers` - MCP server definitions with name, description, command, and args
 
 All changes take effect immediately - just re-run the CLI to deploy your updated config.
@@ -307,7 +307,7 @@ Here's what a complete `config/a11y.json` looks like:
       "description": "Run accessibility tests"
     }
   ],
-  "ides": [
+  "hostApplications": [
     {
       "id": "claude",
       "displayName": "Claude Code",

package/config/a11y.json

@@ -45,7 +45,7 @@
       "description": "Orchestrate accessibility audits"
     }
   ],
-  "ides": [
+  "hostApplications": [
     {
       "id": "claude",
       "displayName": "Claude Code",
@@ -72,17 +72,7 @@
       "displayName": "VSCode",
       "mcpServerKey": "servers",
       "skillsFolder": ".github/skills",
-      "mcpConfigFile": ".github/mcp.json",
-      "globalPaths": {
-        "Win": {
-          "mcpConfigFile": "Code/User/mcp.json",
-          "skillsFolder": "Code/User/skills"
-        },
-        "macOS": {
-          "mcpConfigFile": "Code/User/mcp.json",
-          "skillsFolder": "Code/User/skills"
-        }
-      }
+      "mcpConfigFile": ".github/mcp.json"
     },
     {
       "id": "windsurf",

package/package.json

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

package/src/cli.js

@@ -4,7 +4,7 @@ import { fileURLToPath } from "url";
 import prompts from "prompts";
 
 import { header, info, warn, success, startSpinner, formatPath } from "./ui.js";
-import { getPlatform, getIdePaths, getTempDir, getMcpRepoDir } from "./paths.js";
+import { getPlatform, getHostApplicationPaths, getTempDir, getMcpRepoDir } from "./paths.js";
 import { installSkillsFromNpm, cleanupTemp } from "./installers/skills.js";
 import { installMcpConfig } from "./installers/mcp.js";
 import { getGitMcpPrompts, parseArgsString } from "./prompts/git-mcp.js";
@@ -50,20 +50,20 @@ async function run() {
   const platformInfo = getPlatform();
   const config = await loadConfig();
   const pkg = await loadPackageJson();
-  const idePaths = getIdePaths(projectRoot, platformInfo, config.ides);
+  const hostPaths = getHostApplicationPaths(projectRoot, platformInfo, config.hostApplications);
   const args = parseArgs(process.argv);
 
   header(
     `A11y Devkit Deploy v${pkg.version}`,
     args.gitMcp
       ? "Install MCP server from Git repository"
-      : "Install skills + MCP servers across IDEs",
+      : "Install skills + MCP servers across host applications",
   );
   info(`Detected OS: ${formatOs(platformInfo)}`);
 
   // Branch to Git MCP installation flow
   if (args.gitMcp) {
-    await runGitMcpInstallation(projectRoot, platformInfo, config, idePaths, args);
+    await runGitMcpInstallation(projectRoot, platformInfo, config, hostPaths, args);
     return;
   }
 
@@ -165,14 +165,14 @@ async function run() {
     }
   }
 
-  const ideChoices = config.ides.map((ide) => ({
-    title: ide.displayName,
-    value: ide.id,
+  const hostChoices = config.hostApplications.map((host) => ({
+    title: host.displayName,
+    value: host.id,
   }));
 
   let scope = args.scope;
   let mcpScope = null;
-  let ideSelection = config.ides.map((ide) => ide.id);
+  let hostSelection = config.hostApplications.map((host) => host.id);
 
   if (!args.autoYes) {
     const response = await prompts(
@@ -183,7 +183,7 @@ async function run() {
           message: "Install skills locally or globally?",
           choices: [
             {
-              title: `Local to this project (${formatPath(projectRoot)})`,
+              title: `Local to this project (${formatPath(projectRoot)}) [recommended]`,
               value: "local",
             },
             { title: "Global for this user", value: "global" },
@@ -199,22 +199,22 @@ async function run() {
               title: `Local to this project (${formatPath(projectRoot)})`,
               value: "local",
               description:
-                "Write to project-level IDE config folders (version-controllable)",
+                "Write to project-level host application config folders (version-controllable)",
             },
             {
               title: "Global for this user",
               value: "global",
-              description: "Write to user-level IDE config folders",
+              description: "Write to user-level host application config folders",
             },
           ],
           initial: 0,
         },
         {
           type: "multiselect",
-          name: "ides",
-          message: "Configure for which IDEs?",
-          choices: ideChoices,
-          initial: ideChoices.map((_, index) => index),
+          name: "hosts",
+          message: "Configure for which host applications?",
+          choices: hostChoices,
+          initial: hostChoices.map((_, index) => index),
         },
       ],
       {
@@ -227,7 +227,7 @@ async function run() {
 
     scope = scope || response.scope;
     mcpScope = response.mcpScope || "local";
-    ideSelection = response.ides || ideSelection;
+    hostSelection = response.hosts || hostSelection;
   }
 
   if (!scope) {
@@ -237,8 +237,8 @@ async function run() {
     mcpScope = "local";
   }
 
-  if (!ideSelection.length) {
-    warn("No IDEs selected. MCP installation requires at least one IDE.");
+  if (!hostSelection.length) {
+    warn("No host applications selected. MCP installation requires at least one host application.");
     process.exit(1);
   }
 
@@ -253,8 +253,8 @@ async function run() {
   try {
     const skillTargets =
       scope === "local"
-        ? ideSelection.map((ide) => idePaths[ide].localSkillsDir)
-        : ideSelection.map((ide) => idePaths[ide].skillsDir);
+        ? hostSelection.map((host) => hostPaths[host].localSkillsDir)
+        : hostSelection.map((host) => hostPaths[host].skillsDir);
 
     const skillNames = skillsToInstall.map((skill) =>
       typeof skill === "string" ? skill : skill.npmName,
@@ -267,7 +267,7 @@ async function run() {
       config.readmeTemplate,
     );
     skillsSpinner.succeed(
-      `${result.installed} skills installed to ${skillTargets.length} IDE location(s).`,
+      `${result.installed} skills installed to ${skillTargets.length} host application location(s).`,
     );
   } catch (error) {
     skillsSpinner.fail(`Failed to install skills: ${error.message}`);
@@ -277,19 +277,19 @@ async function run() {
   const mcpSpinner = startSpinner("Updating MCP configurations...");
   const mcpConfigPaths =
     mcpScope === "local"
-      ? ideSelection.map((ide) => idePaths[ide].localMcpConfig)
-      : ideSelection.map((ide) => idePaths[ide].mcpConfig);
+      ? hostSelection.map((host) => hostPaths[host].localMcpConfig)
+      : hostSelection.map((host) => hostPaths[host].mcpConfig);
 
-  for (let i = 0; i < ideSelection.length; i++) {
-    const ide = ideSelection[i];
+  for (let i = 0; i < hostSelection.length; i++) {
+    const host = hostSelection[i];
     await installMcpConfig(
       mcpConfigPaths[i],
       mcpServersToInstall,
-      idePaths[ide].mcpServerKey,
+      hostPaths[host].mcpServerKey,
     );
   }
   mcpSpinner.succeed(
-    `MCP configs updated for ${ideSelection.length} IDE(s) (${mcpScope} scope).`,
+    `MCP configs updated for ${hostSelection.length} host application(s) (${mcpScope} scope).`,
   );
 
   // Clean up temporary directory
@@ -305,8 +305,8 @@ async function run() {
   const skillsFolderPath = config.skillsFolder ? `${config.skillsFolder}/` : "";
   const skillsPath =
     scope === "local"
-      ? `.claude/skills/${skillsFolderPath}README.md (or your IDE's equivalent)`
-      : `~/.claude/skills/${skillsFolderPath}README.md (or your IDE's global skills directory)`;
+      ? `.claude/skills/${skillsFolderPath}README.md (or your host application's equivalent)`
+      : `~/.claude/skills/${skillsFolderPath}README.md (or your host application's global skills directory)`;
   info(`📖 Check ${skillsPath} for comprehensive usage guide`);
   info("✨ Includes 70+ example prompts for all skills and MCP servers");
   info(
@@ -317,7 +317,7 @@ async function run() {
   info("Documentation: https://github.com/joe-watkins/a11y-devkit#readme");
 }
 
-async function runGitMcpInstallation(projectRoot, platformInfo, config, idePaths, 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");
@@ -397,19 +397,19 @@ async function runGitMcpInstallation(projectRoot, platformInfo, config, idePaths
     },
   );
 
-  // Prompt for IDE selection
-  const ideChoices = config.ides.map((ide) => ({
-    title: ide.displayName,
-    value: ide.id,
+  // Prompt for host application selection
+  const hostChoices = config.hostApplications.map((host) => ({
+    title: host.displayName,
+    value: host.id,
   }));
 
-  const ideResponse = await prompts(
+  const hostResponse = await prompts(
     {
       type: "multiselect",
-      name: "ides",
-      message: "Configure MCP for which IDEs?",
-      choices: ideChoices,
-      initial: ideChoices.map((_, index) => index),
+      name: "hosts",
+      message: "Configure MCP for which host applications?",
+      choices: hostChoices,
+      initial: hostChoices.map((_, index) => index),
     },
     {
       onCancel: () => {
@@ -419,10 +419,10 @@ async function runGitMcpInstallation(projectRoot, platformInfo, config, idePaths
     },
   );
 
-  const ideSelection = ideResponse.ides || [];
+  const hostSelection = hostResponse.hosts || [];
 
-  if (!ideSelection.length) {
-    warn("No IDEs selected. MCP installation requires at least one IDE.");
+  if (!hostSelection.length) {
+    warn("No host applications selected. MCP installation requires at least one host application.");
     process.exit(1);
   }
 
@@ -457,13 +457,13 @@ async function runGitMcpInstallation(projectRoot, platformInfo, config, idePaths
     process.exit(1);
   }
 
-  // Install MCP configurations to selected IDEs
+  // Install MCP configurations to selected host applications
   const mcpConfigSpinner = startSpinner("Updating MCP configurations...");
 
   const mcpConfigPaths =
     mcpScope === "local"
-      ? ideSelection.map((ide) => idePaths[ide].localMcpConfig)
-      : ideSelection.map((ide) => idePaths[ide].mcpConfig);
+      ? hostSelection.map((host) => hostPaths[host].localMcpConfig)
+      : hostSelection.map((host) => hostPaths[host].mcpConfig);
 
   // Construct the MCP server configuration with absolute path
   const mcpServerConfig = {
@@ -487,26 +487,26 @@ async function runGitMcpInstallation(projectRoot, platformInfo, config, idePaths
     delete mcpServerConfig.args;
   }
 
-  for (let i = 0; i < ideSelection.length; i++) {
-    const ide = ideSelection[i];
+  for (let i = 0; i < hostSelection.length; i++) {
+    const host = hostSelection[i];
     await installMcpConfig(
       mcpConfigPaths[i],
       [mcpServerConfig],
-      idePaths[ide].mcpServerKey,
+      hostPaths[host].mcpServerKey,
     );
   }
 
   mcpConfigSpinner.succeed(
-    `MCP configs updated for ${ideSelection.length} IDE(s) (${mcpScope} scope).`,
+    `MCP configs updated for ${hostSelection.length} host application(s) (${mcpScope} scope).`,
   );
 
   // Display success message
   success("Git MCP installation complete!");
   info(`Repository location: ${mcpServer.repoPath}`);
-  info(`MCP server '${mcpServer.name}' configured in ${ideSelection.length} IDE(s)`);
+  info(`MCP server '${mcpServer.name}' configured in ${hostSelection.length} host application(s)`);
   console.log("");
   success("Next Steps:");
-  info("Restart your IDE to load the new MCP server");
+  info("Restart your host application to load the new MCP server");
   info(`Repository cloned to: ${mcpServer.repoPath}`);
   info("You can manually edit the MCP configuration files if needed");
 }

package/src/paths.js

@@ -30,47 +30,21 @@ function getAppSupportDir(platformInfo = getPlatform()) {
   return process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
 }
 
-function getIdePaths(projectRoot, platformInfo = getPlatform(), ideConfigs = []) {
+function getHostApplicationPaths(projectRoot, platformInfo = getPlatform(), hostConfigs = []) {
   const home = os.homedir();
-  const appSupport = getAppSupportDir(platformInfo);
   const paths = {};
 
-  for (const ide of ideConfigs) {
-    // Default paths (used for local scope, and global scope if no overrides)
-    let skillsFolder = ide.skillsFolder || `.${ide.id}/skills`;
-    let mcpConfigFile = ide.mcpConfigFile || `.${ide.id}/mcp.json`;
-
-    // Check for platform-specific global path overrides
-    let globalSkillsFolder = skillsFolder;
-    let globalMcpConfigFile = mcpConfigFile;
-
-    if (ide.globalPaths) {
-      const platformKey = platformInfo.isWindows ? 'Win' : platformInfo.isMac ? 'macOS' : null;
-
-      if (platformKey && ide.globalPaths[platformKey]) {
-        const globalOverrides = ide.globalPaths[platformKey];
-
-        // Use app support directory + override path for global
-        if (globalOverrides.skillsFolder) {
-          globalSkillsFolder = globalOverrides.skillsFolder;
-        }
-        if (globalOverrides.mcpConfigFile) {
-          globalMcpConfigFile = globalOverrides.mcpConfigFile;
-        }
-      }
-    }
-
-    // Determine base directory for global paths
-    const useAppSupport = ide.globalPaths &&
-      (platformInfo.isWindows || platformInfo.isMac);
-    const globalBase = useAppSupport ? appSupport : home;
+  for (const host of hostConfigs) {
+    // Default paths for both local and global scope
+    const skillsFolder = host.skillsFolder || `.${host.id}/skills`;
+    const mcpConfigFile = host.mcpConfigFile || `.${host.id}/mcp.json`;
 
-    paths[ide.id] = {
-      name: ide.displayName,
-      mcpConfig: path.join(globalBase, globalMcpConfigFile),
+    paths[host.id] = {
+      name: host.displayName,
+      mcpConfig: path.join(home, mcpConfigFile),
       localMcpConfig: path.join(projectRoot, mcpConfigFile),
-      mcpServerKey: ide.mcpServerKey,
-      skillsDir: path.join(globalBase, globalSkillsFolder),
+      mcpServerKey: host.mcpServerKey,
+      skillsDir: path.join(home, skillsFolder),
       localSkillsDir: path.join(projectRoot, skillsFolder)
     };
   }
@@ -90,7 +64,7 @@ function getMcpRepoDir(scope, projectRoot, platformInfo, mcpName) {
 export {
   getPlatform,
   getAppSupportDir,
-  getIdePaths,
+  getHostApplicationPaths,
   getTempDir,
   getMcpRepoDir
 };