a11y-devkit-deploy 0.8.5 → 0.8.8

package/README.md

@@ -199,17 +199,31 @@ Add an object to the `hostApplications` array with the host application's config
       "mcpServerKey": "servers",
       "skillsFolder": ".codeium/windsurf/skills",
       "mcpConfigFile": ".codeium/windsurf/mcp_config.json"
+    },
+    {
+      "id": "vscode",
+      "displayName": "VSCode",
+      "mcpServerKey": "servers",
+      "skillsFolder": ".github/skills",
+      "mcpConfigFile": ".github/mcp.json",
+      "globalMcpConfigFile": "Code/User/mcp.json"
     }
   ]
 }
 ```
 
+**Note:** The `globalMcpConfigFile` property is optional. When specified, the global MCP config path is relative to the platform's app support directory (AppData on Windows, Application Support on macOS) instead of the home directory.
+
 **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)
 - `mcpConfigFile` - Path to MCP config file (relative to home/project root)
+- `globalMcpConfigFile` - (Optional) Path to global MCP config relative to AppData/Application Support instead of home directory. Used for hosts like VSCode that store configs in platform-specific app directories:
+  - Windows: `%APPDATA%` (e.g., `C:\Users\name\AppData\Roaming`)
+  - macOS: `~/Library/Application Support`
+  - Linux: `$XDG_CONFIG_HOME` or `~/.config`
 
 ### Config Structure
 
@@ -265,7 +279,6 @@ your-project/
   ├── mcp.json              # Codex global MCP config
   └── skills/               # Codex global skills
 ~/.github/
-  ├── mcp.json              # VSCode global MCP config
   └── skills/               # VSCode global skills
 ~/.codeium/windsurf/
   ├── mcp_config.json       # Windsurf global MCP config
@@ -273,6 +286,10 @@ your-project/
 ~/.factory/
   ├── mcp.json              # Factory global MCP config
   └── skills/               # Factory global skills
+
+# VSCode MCP config lives in AppData/Application Support:
+# Windows: %APPDATA%/Code/User/mcp.json
+# macOS:   ~/Library/Application Support/Code/User/mcp.json
 ```
 
 **Note:** Paths are fully customizable per IDE in `config/a11y.json`

package/config/a11y.json

@@ -72,7 +72,8 @@
       "displayName": "VSCode",
       "mcpServerKey": "servers",
       "skillsFolder": ".github/skills",
-      "mcpConfigFile": ".github/mcp.json"
+      "mcpConfigFile": ".github/mcp.json",
+      "globalMcpConfigFile": "Code/User/mcp.json"
     },
     {
       "id": "windsurf",

package/package.json

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

package/src/cli.js

@@ -1,6 +1,26 @@
 import fs from "fs/promises";
 import path from "path";
 import { fileURLToPath } from "url";
+
+// Override kleur's gray color to add italics for better readability
+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') {
+    return `\x1b[3m\x1b[90m${text}\x1b[39m\x1b[23m`;
+  }
+  // Return a function that applies both italic and gray
+  return (str) => `\x1b[3m\x1b[90m${str}\x1b[39m\x1b[23m`;
+};
+
+// Replace gray with italic gray for helper text
+Object.defineProperty(kleur, 'gray', {
+  get() { return grayItalic; },
+  configurable: true
+});
+
 import prompts from "prompts";
 
 import { header, info, warn, success, startSpinner, formatPath } from "./ui.js";
@@ -46,6 +66,9 @@ function formatOs(platformInfo) {
 }
 
 async function run() {
+  // Clear console for a cleaner start
+  console.clear();
+
   const projectRoot = process.cwd();
   const platformInfo = getPlatform();
   const config = await loadConfig();

package/src/paths.js

@@ -32,19 +32,32 @@ function getAppSupportDir(platformInfo = getPlatform()) {
 
 function getHostApplicationPaths(projectRoot, platformInfo = getPlatform(), hostConfigs = []) {
   const home = os.homedir();
+  const appSupport = getAppSupportDir(platformInfo);
   const paths = {};
 
   for (const host of hostConfigs) {
-    // Default paths for both local and global scope
+    // Default paths for local scope (relative to home or project)
     const skillsFolder = host.skillsFolder || `.${host.id}/skills`;
     const mcpConfigFile = host.mcpConfigFile || `.${host.id}/mcp.json`;
 
+    // MCP config: use AppData/Application Support if globalMcpConfigFile specified, otherwise home
+    // appSupport resolves to:
+    //   - Windows: %APPDATA% (e.g., C:\Users\name\AppData\Roaming)
+    //   - macOS: ~/Library/Application Support
+    //   - Linux: $XDG_CONFIG_HOME or ~/.config
+    const globalMcpConfig = host.globalMcpConfigFile
+      ? path.join(appSupport, host.globalMcpConfigFile)
+      : path.join(home, mcpConfigFile);
+
+    // Skills always use home directory (skills live at project level, not in AppData)
+    const globalSkillsDir = path.join(home, skillsFolder);
+
     paths[host.id] = {
       name: host.displayName,
-      mcpConfig: path.join(home, mcpConfigFile),
+      mcpConfig: globalMcpConfig,
       localMcpConfig: path.join(projectRoot, mcpConfigFile),
       mcpServerKey: host.mcpServerKey,
-      skillsDir: path.join(home, skillsFolder),
+      skillsDir: globalSkillsDir,
       localSkillsDir: path.join(projectRoot, skillsFolder)
     };
   }

package/src/ui.js

@@ -10,7 +10,7 @@ const bullets = {
 };
 
 function header(title, subtitle) {
-  const line = subtitle ? `${pc.dim(subtitle)}` : "";
+  const line = subtitle ? `${pc.gray(subtitle)}` : "";
   const content = [pc.bold(title), line].filter(Boolean).join("\n");
   console.log(
     boxen(content, {
@@ -43,7 +43,7 @@ function startSpinner(text) {
 }
 
 function formatPath(value) {
-  return pc.dim(value);
+  return pc.gray(value);
 }
 
 export {