@wonderwhy-er/desktop-commander 0.2.18-alpha.9 → 0.2.21

package/dist/config-manager.js

@@ -101,7 +101,15 @@ class ConfigManager {
                 "cipher", // Encrypt/decrypt files or wipe data
                 "takeown" // Take ownership of files
             ],
-            defaultShell: os.platform() === 'win32' ? 'powershell.exe' : '/bin/sh',
+            defaultShell: (() => {
+                if (os.platform() === 'win32') {
+                    return 'powershell.exe';
+                }
+                // Use user's actual shell from environment, or fall back to /bin/sh
+                const userShell = process.env.SHELL || '/bin/sh';
+                // Return just the shell path - we'll handle login shell flag elsewhere
+                return userShell;
+            })(),
             allowedDirectories: [],
             telemetryEnabled: true, // Default to opt-out approach (telemetry on by default)
             fileWriteLineLimit: 50, // Default line limit for file write operations (changed from 100)

package/dist/custom-stdio.d.ts

@@ -8,11 +8,18 @@ export declare class FilteredStdioServerTransport extends StdioServerTransport {
     private originalStdoutWrite;
     private isInitialized;
     private messageBuffer;
+    private clientName;
+    private disableNotifications;
     constructor();
     /**
      * Call this method after MCP initialization is complete to enable JSON-RPC notifications
      */
     enableNotifications(): void;
+    /**
+     * Configure client-specific behavior
+     * Call this BEFORE enableNotifications()
+     */
+    configureForClient(clientName: string): void;
     /**
      * Check if notifications are enabled
      */

package/dist/custom-stdio.js

@@ -9,6 +9,8 @@ export class FilteredStdioServerTransport extends StdioServerTransport {
         super();
         this.isInitialized = false;
         this.messageBuffer = [];
+        this.clientName = 'unknown';
+        this.disableNotifications = false;
         // Store original methods
         this.originalConsole = {
             log: console.log,
@@ -30,6 +32,15 @@ export class FilteredStdioServerTransport extends StdioServerTransport {
      */
     enableNotifications() {
         this.isInitialized = true;
+        // Check if notifications should be disabled based on client
+        if (this.disableNotifications) {
+            // Clear buffer without sending - just log to stderr instead
+            if (this.messageBuffer.length > 0) {
+                process.stderr.write(`[INFO] ${this.messageBuffer.length} buffered messages suppressed for ${this.clientName}\n`);
+            }
+            this.messageBuffer = [];
+            return;
+        }
         // Send the deferred initialization notification first
         this.sendLogNotification('info', ['Enhanced FilteredStdioServerTransport initialized']);
         // Replay all buffered messages in chronological order
@@ -45,6 +56,20 @@ export class FilteredStdioServerTransport extends StdioServerTransport {
         }
         this.sendLogNotification('info', ['JSON-RPC notifications enabled']);
     }
+    /**
+     * Configure client-specific behavior
+     * Call this BEFORE enableNotifications()
+     */
+    configureForClient(clientName) {
+        this.clientName = clientName.toLowerCase();
+        // Detect Cline and disable notifications
+        if (this.clientName.includes('cline') ||
+            this.clientName.includes('vscode') ||
+            this.clientName === 'claude-dev') {
+            this.disableNotifications = true;
+            process.stderr.write(`[INFO] Desktop Commander: Notifications disabled for ${clientName}\n`);
+        }
+    }
     /**
      * Check if notifications are enabled
      */
@@ -155,6 +180,10 @@ export class FilteredStdioServerTransport extends StdioServerTransport {
         };
     }
     sendLogNotification(level, args) {
+        // Skip if notifications are disabled (e.g., for Cline)
+        if (this.disableNotifications) {
+            return;
+        }
         try {
             // For data, we can send structured data or string according to MCP spec
             let data;
@@ -206,6 +235,10 @@ export class FilteredStdioServerTransport extends StdioServerTransport {
      * Public method to send log notifications from anywhere in the application
      */
     sendLog(level, message, data) {
+        // Skip if notifications are disabled (e.g., for Cline)
+        if (this.disableNotifications) {
+            return;
+        }
         try {
             const notification = {
                 jsonrpc: "2.0",

package/dist/server.js

@@ -70,6 +70,11 @@ server.setRequestHandler(InitializeRequestSchema, async (request) => {
                 name: clientInfo.name || 'unknown',
                 version: clientInfo.version || 'unknown'
             };
+            // Configure transport for client-specific behavior
+            const transport = global.mcpTransport;
+            if (transport && typeof transport.configureForClient === 'function') {
+                transport.configureForClient(currentClient.name);
+            }
             // Defer client connection message until after initialization
             deferLog('info', `Client connected: ${currentClient.name} v${currentClient.version}`);
         }

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,13 +643,9 @@ async function restartClaude() {
 
 // Main function to export for ESM compatibility
 export default async function setup() {
-    // VERY FIRST THING - test if stderr works AT ALL
-    process.stderr.write('\n\n========== SETUP FUNCTION STARTED ==========\n');
-    process.stderr.write(`__dirname: ${__dirname}\n`);
-    process.stderr.write(`__filename: ${__filename}\n`);
-    process.stderr.write(`process.argv: ${JSON.stringify(process.argv)}\n`);
-    process.stderr.write('=============================================\n\n');
-    
+    // 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');
 
@@ -779,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
@@ -799,7 +762,7 @@ export default async function setup() {
                         "DEBUG": "*"
                     };
 
-                    const packageSpec = getPackageSpec();
+                    const packageSpec = getPackageSpec(versionArg);
                     serverConfig = {
                         "command": isWindows ? "node.exe" : "node",
                         "args": [
@@ -835,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
@@ -881,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/terminal-manager.js

@@ -1,8 +1,63 @@
 import { spawn } from 'child_process';
+import path from 'path';
 import { DEFAULT_COMMAND_TIMEOUT } from './config.js';
 import { configManager } from './config-manager.js';
 import { capture } from "./utils/capture.js";
 import { analyzeProcessState } from './utils/process-detection.js';
+/**
+ * Get the appropriate spawn configuration for a given shell
+ * This handles login shell flags for different shell types
+ */
+function getShellSpawnArgs(shellPath, command) {
+    const shellName = path.basename(shellPath).toLowerCase();
+    // Unix shells with login flag support
+    if (shellName.includes('bash') || shellName.includes('zsh')) {
+        return {
+            executable: shellPath,
+            args: ['-l', '-c', command],
+            useShellOption: false
+        };
+    }
+    // PowerShell Core (cross-platform, supports -Login)
+    if (shellName === 'pwsh' || shellName === 'pwsh.exe') {
+        return {
+            executable: shellPath,
+            args: ['-Login', '-Command', command],
+            useShellOption: false
+        };
+    }
+    // Windows PowerShell 5.1 (no login flag support)
+    if (shellName === 'powershell' || shellName === 'powershell.exe') {
+        return {
+            executable: shellPath,
+            args: ['-Command', command],
+            useShellOption: false
+        };
+    }
+    // CMD
+    if (shellName === 'cmd' || shellName === 'cmd.exe') {
+        return {
+            executable: shellPath,
+            args: ['/c', command],
+            useShellOption: false
+        };
+    }
+    // Fish shell (uses -l for login, -c for command)
+    if (shellName.includes('fish')) {
+        return {
+            executable: shellPath,
+            args: ['-l', '-c', command],
+            useShellOption: false
+        };
+    }
+    // Unknown/other shells - use shell option for safety
+    // This provides a fallback for shells we don't explicitly handle
+    return {
+        executable: command,
+        args: [],
+        useShellOption: shellPath
+    };
+}
 export class TerminalManager {
     constructor() {
         this.sessions = new Map();
@@ -54,15 +109,40 @@ export class TerminalManager {
             enhancedCommand = command.replace(/^ssh /, 'ssh -t ');
             console.log(`Enhanced SSH command: ${enhancedCommand}`);
         }
-        const spawnOptions = {
-            shell: shellToUse,
-            env: {
-                ...process.env,
-                TERM: 'xterm-256color' // Better terminal compatibility
+        // Get the appropriate spawn configuration for the shell
+        let spawnConfig;
+        let spawnOptions;
+        if (typeof shellToUse === 'string') {
+            // Use shell-specific configuration with login flags where appropriate
+            spawnConfig = getShellSpawnArgs(shellToUse, enhancedCommand);
+            spawnOptions = {
+                env: {
+                    ...process.env,
+                    TERM: 'xterm-256color' // Better terminal compatibility
+                }
+            };
+            // Add shell option if needed (for unknown shells)
+            if (spawnConfig.useShellOption) {
+                spawnOptions.shell = spawnConfig.useShellOption;
             }
-        };
-        // Spawn the process with an empty array of arguments and our options
-        const childProcess = spawn(enhancedCommand, [], spawnOptions);
+        }
+        else {
+            // Boolean or undefined shell - use default shell option behavior
+            spawnConfig = {
+                executable: enhancedCommand,
+                args: [],
+                useShellOption: shellToUse
+            };
+            spawnOptions = {
+                shell: shellToUse,
+                env: {
+                    ...process.env,
+                    TERM: 'xterm-256color'
+                }
+            };
+        }
+        // Spawn the process with appropriate arguments
+        const childProcess = spawn(spawnConfig.executable, spawnConfig.args, spawnOptions);
         let output = '';
         // Ensure childProcess.pid is defined before proceeding
         if (!childProcess.pid) {

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.9";
+export declare const VERSION = "0.2.21";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.2.18-alpha.9';
+export const VERSION = '0.2.21';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wonderwhy-er/desktop-commander",
-  "version": "0.2.18-alpha.9",
+  "version": "0.2.21",
   "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",
@@ -86,6 +87,7 @@
     "zod-to-json-schema": "^3.23.5"
   },
   "devDependencies": {
+    "@anthropic-ai/mcpb": "^1.2.0",
     "@types/node": "^20.17.24",
     "commander": "^13.1.0",
     "nexe": "^5.0.0-beta.4",