@wonderwhy-er/desktop-commander 0.2.18-alpha.8 → 0.2.19

package/dist/setup-claude-server.js

@@ -207,74 +207,43 @@ function detectShell() {
 }
 
 // Function to get the package spec that was used to run this script
-function getPackageSpec() {
-  // Use stderr for debug output so it's always visible
-  const debug = (msg) => process.stderr.write(`${msg}\n`);
-  
-  debug('\n[DEBUG getPackageSpec] Starting detection...');
-  debug(`[DEBUG getPackageSpec] process.argv: ${JSON.stringify(process.argv)}`);
-  debug(`[DEBUG getPackageSpec] __dirname: ${__dirname}`);
-  debug(`[DEBUG getPackageSpec] __filename: ${__filename}`);
-  
-  // Strategy: Check multiple sources to detect the version
-  // 1. Check process.argv[1] which contains the actual script path  
-  // 2. Check package.json in the script's directory
-  // 3. Fall back to @latest for stable, keep version for pre-release
-  
-  // Method 1: Check the script path (process.argv[1] or __dirname)
-  // npx extracts packages to: ~/.npm/_npx/<hash>/node_modules/@scope/package-name/
-  // The actual script path will contain this structure
-  const scriptPath = __dirname;
-  debug('[DEBUG getPackageSpec] Checking script path for version...');
-  
-  // Look for node_modules/@wonderwhy-er/desktop-commander in the path
-  // This works because npx extracts to a predictable location
-  const nodeModulesMatch = scriptPath.match(/node_modules\/@wonderwhy-er\/desktop-commander/);
-  if (nodeModulesMatch) {
-    debug('[DEBUG getPackageSpec] Script is in node_modules, reading package.json...');
+function getPackageSpec(versionArg = null) {
+  // If explicit version/tag argument provided, use it
+  // Usage: npx @wonderwhy-er/desktop-commander setup alpha
+  if (versionArg) {
+    return `@wonderwhy-er/desktop-commander@${versionArg}`;
   }
   
-  // Method 2: Read package.json to get the actual installed version
-  try {
-    const packageJsonPath = join(__dirname, 'package.json');
-    debug(`[DEBUG getPackageSpec] Trying to read: ${packageJsonPath}`);
-    
-    if (existsSync(packageJsonPath)) {
-      const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
-      const version = packageJson.version;
-      debug(`[DEBUG getPackageSpec] Found version in package.json: ${version}`);
-      
-      if (version) {
-        // Always use the exact version if it's a pre-release
-        if (version.includes('alpha') || version.includes('beta') || version.includes('rc')) {
-          const spec = `@wonderwhy-er/desktop-commander@${version}`;
-          debug(`[DEBUG getPackageSpec] ✓ Using pre-release version: ${spec}`);
-          return spec;
-        }
-        
-        // For stable versions, use @latest tag
-        debug('[DEBUG getPackageSpec] ✓ Stable version, using @latest');
-        return '@wonderwhy-er/desktop-commander@latest';
+  // Check if running via npx - look for the package spec in process.argv
+  // e.g., npx @wonderwhy-er/desktop-commander@0.2.18-alpha setup
+  const argv = process.argv;
+  
+  // Look for the package name in argv
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.includes('@wonderwhy-er/desktop-commander')) {
+      // Extract just the package spec (e.g., @wonderwhy-er/desktop-commander@0.2.18-alpha)
+      const match = arg.match(/(@wonderwhy-er\/desktop-commander(@[^\/\s]+)?)/);
+      if (match) {
+        return match[1];
       }
-    } else {
-      debug('[DEBUG getPackageSpec] ✗ package.json not found');
     }
-  } catch (error) {
-    debug(`[DEBUG getPackageSpec] ✗ Error reading package.json: ${error.message}`);
   }
   
-  // Fallback
-  debug('[DEBUG getPackageSpec] ⚠ Falling back to @latest');
+  // Fallback to @latest if we can't detect
   return '@wonderwhy-er/desktop-commander@latest';
 }
 
+function isNPX() {
+    return process.env.npm_lifecycle_event === 'npx' ||
+        process.env.npm_execpath?.includes('npx') ||
+        process.env._?.includes('npx') ||
+        import.meta.url.includes('node_modules');
+}
 // Function to determine execution context
 function getExecutionContext() {
   // Check if running from npx
-  const isNpx = process.env.npm_lifecycle_event === 'npx' ||
-                process.env.npm_execpath?.includes('npx') ||
-                process.env._?.includes('npx') ||
-                import.meta.url.includes('node_modules');
+  const isNpx = isNPX();
 
   // Check if installed globally
   const isGlobal = process.env.npm_config_global === 'true' ||
@@ -674,6 +643,9 @@ async function restartClaude() {
 
 // Main function to export for ESM compatibility
 export default async function setup() {
+    // Parse command line arguments for version/tag
+    const versionArg = process.argv[3]; // argv[0]=node, argv[1]=script, argv[2]=version/tag
+
     // Add tracking for setup function entry
     await trackEvent('npx_setup_function_started');
 
@@ -772,9 +744,7 @@ export default async function setup() {
         const configPrepStep = addSetupStep('prepare_server_config');
 
         // Determine if running through npx or locally
-        const isNpx = import.meta.url.includes('node_modules');
-        process.stderr.write(`\n[SETUP] import.meta.url: ${import.meta.url}\n`);
-        process.stderr.write(`[SETUP] isNpx: ${isNpx}\n`);
+        const isNpx = isNPX();
         await trackEvent('npx_setup_execution_mode', { isNpx });
 
         // Fix Windows path handling for npx execution
@@ -792,7 +762,7 @@ export default async function setup() {
                         "DEBUG": "*"
                     };
 
-                    const packageSpec = getPackageSpec();
+                    const packageSpec = getPackageSpec(versionArg);
                     serverConfig = {
                         "command": isWindows ? "node.exe" : "node",
                         "args": [
@@ -828,15 +798,13 @@ export default async function setup() {
             } else {
                 // Standard configuration without debug
                 if (isNpx) {
-                    const packageSpec = getPackageSpec();
-                    process.stderr.write(`\n[SETUP] Creating config with package spec: ${packageSpec}\n`);
+                    const packageSpec = getPackageSpec(versionArg);
                     serverConfig = {
                         "command": isWindows ? "npx.cmd" : "npx",
                         "args": [
                             packageSpec
                         ]
                     };
-                    process.stderr.write(`[SETUP] serverConfig.args: ${JSON.stringify(serverConfig.args)}\n`);
                     await trackEvent('npx_setup_config_standard_npx', { packageSpec });
                 } else {
                     // For local installation, use absolute path to handle Windows properly
@@ -874,16 +842,8 @@ export default async function setup() {
             // Add or update the terminal server config with the proper name "desktop-commander"
             config.mcpServers["desktop-commander"] = serverConfig;
 
-            process.stderr.write('\n[SETUP] Writing config to Claude:\n');
-            process.stderr.write(`[SETUP] desktop-commander args: ${JSON.stringify(config.mcpServers["desktop-commander"].args)}\n`);
-
             // Write the updated config back
             writeFileSync(claudeConfigPath, JSON.stringify(config, null, 2), 'utf8');
-            
-            // Verify what was written
-            const writtenConfig = JSON.parse(readFileSync(claudeConfigPath, 'utf8'));
-            process.stderr.write(`[SETUP] Verified written args: ${JSON.stringify(writtenConfig.mcpServers["desktop-commander"].args)}\n\n`);
-            
             updateSetupStep(updateConfigStep, 'completed');
             await trackEvent('npx_setup_update_config');
         } catch (updateError) {

package/dist/setup.log

@@ -82,3 +82,194 @@ The server is available as "desktop-commander" in Claude's MCP server list
 2025-10-22T15:22:46.665Z - or join our community: https://discord.com/invite/kQ27sNnZr7
 
 
+2025-10-23T10:10:37.029Z - ✅ Desktop Commander MCP v0.2.18-alpha.13 successfully added to Claude’s configuration.
+2025-10-23T10:10:37.030Z - Configuration location: /Users/fiberta/Library/Application Support/Claude/claude_desktop_config.json
+2025-10-23T10:10:40.163Z - 
+✅ Claude has been restarted automatically!
+2025-10-23T10:10:40.184Z - 
+✅ Installation successfully completed! Thank you for using Desktop Commander!
+
+2025-10-23T10:10:40.184Z - 
+The server is available as "desktop-commander" in Claude's MCP server list
+2025-10-23T10:10:40.184Z - Future updates will install automatically — no need to run this setup again.
+
+
+2025-10-23T10:10:40.184Z - 🤔 Need help or have feedback? Happy to jump on a quick call: 
+
+
+2025-10-23T10:10:40.184Z - https://calendar.app.google/SHMNZN5MJznJWC5A7 
+
+
+2025-10-23T10:10:40.184Z - or join our community: https://discord.com/invite/kQ27sNnZr7
+
+
+2025-10-23T10:11:28.520Z - ✅ Desktop Commander MCP v0.2.18-alpha.13 successfully added to Claude’s configuration.
+2025-10-23T10:11:28.520Z - Configuration location: /Users/fiberta/Library/Application Support/Claude/claude_desktop_config.json
+2025-10-23T10:11:31.626Z - 
+✅ Claude has been restarted automatically!
+2025-10-23T10:11:31.645Z - 
+✅ Installation successfully completed! Thank you for using Desktop Commander!
+
+2025-10-23T10:11:31.645Z - 
+The server is available as "desktop-commander" in Claude's MCP server list
+2025-10-23T10:11:31.645Z - Future updates will install automatically — no need to run this setup again.
+
+
+2025-10-23T10:11:31.645Z - 🤔 Need help or have feedback? Happy to jump on a quick call: 
+
+
+2025-10-23T10:11:31.645Z - https://calendar.app.google/SHMNZN5MJznJWC5A7 
+
+
+2025-10-23T10:11:31.645Z - or join our community: https://discord.com/invite/kQ27sNnZr7
+
+
+2025-10-23T10:19:51.580Z - ✅ Desktop Commander MCP v0.2.18-alpha.13 successfully added to Claude’s configuration.
+2025-10-23T10:19:51.580Z - Configuration location: /Users/fiberta/Library/Application Support/Claude/claude_desktop_config.json
+2025-10-23T10:19:54.733Z - 
+✅ Claude has been restarted automatically!
+2025-10-23T10:19:54.755Z - 
+✅ Installation successfully completed! Thank you for using Desktop Commander!
+
+2025-10-23T10:19:54.755Z - 
+The server is available as "desktop-commander" in Claude's MCP server list
+2025-10-23T10:19:54.756Z - Future updates will install automatically — no need to run this setup again.
+
+
+2025-10-23T10:19:54.756Z - 🤔 Need help or have feedback? Happy to jump on a quick call: 
+
+
+2025-10-23T10:19:54.756Z - https://calendar.app.google/SHMNZN5MJznJWC5A7 
+
+
+2025-10-23T10:19:54.756Z - or join our community: https://discord.com/invite/kQ27sNnZr7
+
+
+2025-10-23T10:20:46.785Z - ✅ Desktop Commander MCP v0.2.18-alpha.13 successfully added to Claude’s configuration.
+2025-10-23T10:20:46.785Z - Configuration location: /Users/fiberta/Library/Application Support/Claude/claude_desktop_config.json
+2025-10-23T10:20:49.891Z - 
+✅ Claude has been restarted automatically!
+2025-10-23T10:20:49.913Z - 
+✅ Installation successfully completed! Thank you for using Desktop Commander!
+
+2025-10-23T10:20:49.913Z - 
+The server is available as "desktop-commander" in Claude's MCP server list
+2025-10-23T10:20:49.913Z - Future updates will install automatically — no need to run this setup again.
+
+
+2025-10-23T10:20:49.913Z - 🤔 Need help or have feedback? Happy to jump on a quick call: 
+
+
+2025-10-23T10:20:49.913Z - https://calendar.app.google/SHMNZN5MJznJWC5A7 
+
+
+2025-10-23T10:20:49.913Z - or join our community: https://discord.com/invite/kQ27sNnZr7
+
+
+2025-10-23T10:23:37.739Z - ✅ Desktop Commander MCP v0.2.18-alpha.14 successfully added to Claude’s configuration.
+2025-10-23T10:23:37.739Z - Configuration location: /Users/fiberta/Library/Application Support/Claude/claude_desktop_config.json
+2025-10-23T10:23:40.846Z - 
+✅ Claude has been restarted automatically!
+2025-10-23T10:23:40.867Z - 
+✅ Installation successfully completed! Thank you for using Desktop Commander!
+
+2025-10-23T10:23:40.867Z - 
+The server is available as "desktop-commander" in Claude's MCP server list
+2025-10-23T10:23:40.867Z - Future updates will install automatically — no need to run this setup again.
+
+
+2025-10-23T10:23:40.867Z - 🤔 Need help or have feedback? Happy to jump on a quick call: 
+
+
+2025-10-23T10:23:40.867Z - https://calendar.app.google/SHMNZN5MJznJWC5A7 
+
+
+2025-10-23T10:23:40.867Z - or join our community: https://discord.com/invite/kQ27sNnZr7
+
+
+2025-10-23T10:39:56.359Z - ✅ Desktop Commander MCP v0.2.18-alpha.15 successfully added to Claude’s configuration.
+2025-10-23T10:39:56.360Z - Configuration location: /Users/fiberta/Library/Application Support/Claude/claude_desktop_config.json
+2025-10-23T10:39:59.526Z - 
+✅ Claude has been restarted automatically!
+2025-10-23T10:39:59.567Z - 
+✅ Installation successfully completed! Thank you for using Desktop Commander!
+
+2025-10-23T10:39:59.567Z - 
+The server is available as "desktop-commander" in Claude's MCP server list
+2025-10-23T10:39:59.567Z - Future updates will install automatically — no need to run this setup again.
+
+
+2025-10-23T10:39:59.567Z - 🤔 Need help or have feedback? Happy to jump on a quick call: 
+
+
+2025-10-23T10:39:59.567Z - https://calendar.app.google/SHMNZN5MJznJWC5A7 
+
+
+2025-10-23T10:39:59.567Z - or join our community: https://discord.com/invite/kQ27sNnZr7
+
+
+2025-10-23T10:57:55.850Z - ✅ Desktop Commander MCP v0.2.18-alpha.15 successfully added to Claude’s configuration.
+2025-10-23T10:57:55.851Z - Configuration location: /Users/fiberta/Library/Application Support/Claude/claude_desktop_config.json
+2025-10-23T10:57:59.008Z - 
+✅ Claude has been restarted automatically!
+2025-10-23T10:57:59.051Z - 
+✅ Installation successfully completed! Thank you for using Desktop Commander!
+
+2025-10-23T10:57:59.052Z - 
+The server is available as "desktop-commander" in Claude's MCP server list
+2025-10-23T10:57:59.052Z - Future updates will install automatically — no need to run this setup again.
+
+
+2025-10-23T10:57:59.052Z - 🤔 Need help or have feedback? Happy to jump on a quick call: 
+
+
+2025-10-23T10:57:59.052Z - https://calendar.app.google/SHMNZN5MJznJWC5A7 
+
+
+2025-10-23T10:57:59.052Z - or join our community: https://discord.com/invite/kQ27sNnZr7
+
+
+2025-10-23T11:06:27.679Z - ERROR: Command args: 
+2025-10-23T11:06:32.852Z - ✅ Desktop Commander MCP v0.2.18-alpha.16 successfully added to Claude’s configuration.
+2025-10-23T11:06:32.852Z - Configuration location: /Users/fiberta/Library/Application Support/Claude/claude_desktop_config.json
+2025-10-23T11:06:36.008Z - 
+✅ Claude has been restarted automatically!
+2025-10-23T11:06:36.050Z - 
+✅ Installation successfully completed! Thank you for using Desktop Commander!
+
+2025-10-23T11:06:36.050Z - 
+The server is available as "desktop-commander" in Claude's MCP server list
+2025-10-23T11:06:36.050Z - Future updates will install automatically — no need to run this setup again.
+
+
+2025-10-23T11:06:36.050Z - 🤔 Need help or have feedback? Happy to jump on a quick call: 
+
+
+2025-10-23T11:06:36.050Z - https://calendar.app.google/SHMNZN5MJznJWC5A7 
+
+
+2025-10-23T11:06:36.050Z - or join our community: https://discord.com/invite/kQ27sNnZr7
+
+
+2025-10-23T11:17:02.302Z - ERROR: Command args: 
+2025-10-23T11:17:02.385Z - ✅ Desktop Commander MCP v0.2.18-alpha.16 successfully added to Claude’s configuration.
+2025-10-23T11:17:02.385Z - Configuration location: /Users/fiberta/Library/Application Support/Claude/claude_desktop_config.json
+2025-10-23T11:17:05.568Z - 
+✅ Claude has been restarted automatically!
+2025-10-23T11:17:05.612Z - 
+✅ Installation successfully completed! Thank you for using Desktop Commander!
+
+2025-10-23T11:17:05.612Z - 
+The server is available as "desktop-commander" in Claude's MCP server list
+2025-10-23T11:17:05.612Z - Future updates will install automatically — no need to run this setup again.
+
+
+2025-10-23T11:17:05.612Z - 🤔 Need help or have feedback? Happy to jump on a quick call: 
+
+
+2025-10-23T11:17:05.612Z - https://calendar.app.google/SHMNZN5MJznJWC5A7 
+
+
+2025-10-23T11:17:05.613Z - or join our community: https://discord.com/invite/kQ27sNnZr7
+
+

package/dist/test-setup.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+// Test what argv looks like when called as a bin script
+console.log('=== Test Script Argv ===');
+console.log('process.argv:');
+process.argv.forEach((arg, index) => {
+  console.log(`  ${index}: "${arg}"`);
+});
+
+const versionArg2 = process.argv[2];
+const versionArg3 = process.argv[3];
+
+console.log('\nUsing argv[2]:', versionArg2);
+console.log('Using argv[3]:', versionArg3);

package/dist/utils/feature-flags.js

@@ -7,7 +7,7 @@ class FeatureFlagManager {
     constructor() {
         this.flags = {};
         this.lastFetch = 0;
-        this.cacheMaxAge = 30 * 60 * 1000; // 5 minutes - hardcoded refresh interval
+        this.cacheMaxAge = 30 * 60 * 1000;
         this.refreshInterval = null;
         const configDir = path.dirname(CONFIG_FILE);
         this.cachePath = path.join(configDir, 'feature-flags.json');

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.2.18-alpha.8";
+export declare const VERSION = "0.2.19";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.2.18-alpha.8';
+export const VERSION = '0.2.19';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wonderwhy-er/desktop-commander",
-  "version": "0.2.18-alpha.8",
+  "version": "0.2.19",
   "description": "MCP server for terminal operations and file editing",
   "mcpName": "io.github.wonderwhy-er/desktop-commander",
   "license": "MIT",
@@ -39,6 +39,7 @@
     "clean": "shx rm -rf dist",
     "test": "npm run build && node test/run-all-tests.js",
     "test:debug": "node --inspect test/run-all-tests.js",
+    "validate:tools": "npm run build && node scripts/validate-tools-sync.js",
     "link:local": "npm run build && npm link",
     "unlink:local": "npm unlink",
     "inspector": "npx @modelcontextprotocol/inspector dist/index.js",