@wonderwhy-er/desktop-commander 0.2.14 → 0.2.16

package/README.md

@@ -86,6 +86,11 @@ For debugging mode (allows Node.js inspector connection):
 ```
 npx @wonderwhy-er/desktop-commander@latest setup --debug
 ```
+
+**Command line options during setup:**
+- `--debug`: Enable debugging mode for Node.js inspector
+- `--no-onboarding`: Disable onboarding prompts for new users
+
 Restart Claude if running.
 
 **✅ Auto-Updates:** Yes - automatically updates when you restart Claude  
@@ -652,6 +657,44 @@ set_config_value({ "key": "fileWriteLineLimit", "value": 25 })
 
 4. **Always verify configuration after changes**: Use `get_config({})` to confirm your changes were applied correctly.
 
+## Command Line Options
+
+Desktop Commander supports several command line options for customizing behavior:
+
+### Disable Onboarding
+
+By default, Desktop Commander shows helpful onboarding prompts to new users (those with fewer than 10 tool calls). You can disable this behavior:
+
+```bash
+# Disable onboarding for this session
+node dist/index.js --no-onboarding
+
+# Or if using npm scripts
+npm run start:no-onboarding
+
+# For npx installations, modify your claude_desktop_config.json:
+{
+  "mcpServers": {
+    "desktop-commander": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@wonderwhy-er/desktop-commander@latest",
+        "--no-onboarding"
+      ]
+    }
+  }
+}
+```
+
+**When onboarding is automatically disabled:**
+- When the MCP client name is set to "desktop-commander"
+- When using the `--no-onboarding` flag
+- After users have used onboarding prompts or made 10+ tool calls
+
+**Debug information:**
+The server will log when onboarding is disabled: `"Onboarding disabled via --no-onboarding flag"`
+
 ## Using Different Shells
 
 You can specify which shell to use for command execution:
@@ -911,7 +954,7 @@ External telemetry (sent to analytics services) is enabled by default but can be
 
 **Note:** This only disables external telemetry. Local usage analytics remain active for tool functionality but is not share externally
 
-For complete details about data collection, please see our [Privacy Policy](PRIVACY.md).
+For complete details about data collection, please see our [Privacy Policy](https://legal.desktopcommander.app/privacy_desktop_commander_mcp).
 
 ## Verifications
 [![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/25ff7a06-58bc-40b8-bd79-ebb715140f1a)

package/dist/custom-stdio.js

@@ -22,14 +22,16 @@ export class FilteredStdioServerTransport extends StdioServerTransport {
         this.setupConsoleRedirection();
         // Setup stdout filtering for any other output
         this.setupStdoutFiltering();
-        // Send initialization notification
-        this.sendLogNotification('info', ['Enhanced FilteredStdioServerTransport initialized']);
+        // Note: We defer the initialization notification until enableNotifications() is called
+        // to ensure MCP protocol compliance - notifications must not be sent before initialization
     }
     /**
      * Call this method after MCP initialization is complete to enable JSON-RPC notifications
      */
     enableNotifications() {
         this.isInitialized = true;
+        // Send the deferred initialization notification first
+        this.sendLogNotification('info', ['Enhanced FilteredStdioServerTransport initialized']);
         // Replay all buffered messages in chronological order
         if (this.messageBuffer.length > 0) {
             this.sendLogNotification('info', [`Replaying ${this.messageBuffer.length} buffered initialization messages`]);

package/dist/handlers/search-handlers.js

@@ -132,6 +132,10 @@ export async function handleGetMoreSearchResults(args) {
         }
         if (results.isComplete) {
             output += `\n✅ Search completed.`;
+            // Warn users if search was incomplete due to permission issues
+            if (results.wasIncomplete) {
+                output += `\n⚠️  Warning: Some files were inaccessible due to permissions. Results may be incomplete.`;
+            }
         }
         return {
             content: [{ type: "text", text: output }],

package/dist/index.js

@@ -1,11 +1,16 @@
 #!/usr/bin/env node
 import { FilteredStdioServerTransport } from './custom-stdio.js';
-import { server } from './server.js';
+import { server, flushDeferredMessages } from './server.js';
 import { configManager } from './config-manager.js';
 import { runSetup } from './npm-scripts/setup.js';
 import { runUninstall } from './npm-scripts/uninstall.js';
 import { capture } from './utils/capture.js';
 import { logToStderr, logger } from './utils/logger.js';
+// Store messages to defer until after initialization
+const deferredMessages = [];
+function deferLog(level, message) {
+    deferredMessages.push({ level, message });
+}
 async function runServer() {
     try {
         // Check if first argument is "setup"
@@ -18,17 +23,24 @@ async function runServer() {
             await runUninstall();
             return;
         }
+        // Parse command line arguments for onboarding control
+        const DISABLE_ONBOARDING = process.argv.includes('--no-onboarding');
+        if (DISABLE_ONBOARDING) {
+            logToStderr('info', 'Onboarding disabled via --no-onboarding flag');
+        }
+        // Set global flag for onboarding control
+        global.disableOnboarding = DISABLE_ONBOARDING;
         try {
-            logToStderr('info', 'Loading configuration...');
+            deferLog('info', 'Loading configuration...');
             await configManager.loadConfig();
-            logToStderr('info', 'Configuration loaded successfully');
+            deferLog('info', 'Configuration loaded successfully');
         }
         catch (configError) {
-            logToStderr('error', `Failed to load configuration: ${configError instanceof Error ? configError.message : String(configError)}`);
+            deferLog('error', `Failed to load configuration: ${configError instanceof Error ? configError.message : String(configError)}`);
             if (configError instanceof Error && configError.stack) {
-                logToStderr('debug', `Stack trace: ${configError.stack}`);
+                deferLog('debug', `Stack trace: ${configError.stack}`);
             }
-            logToStderr('warning', 'Continuing with in-memory configuration only');
+            deferLog('warning', 'Continuing with in-memory configuration only');
             // Continue anyway - we'll use an in-memory config
         }
         const transport = new FilteredStdioServerTransport();
@@ -63,17 +75,23 @@ async function runServer() {
             process.exit(1);
         });
         capture('run_server_start');
-        logToStderr('info', 'Connecting server...');
+        deferLog('info', 'Connecting server...');
         // Set up event-driven initialization completion handler
         server.oninitialized = () => {
             // This callback is triggered after the client sends the "initialized" notification
             // At this point, the MCP protocol handshake is fully complete
             transport.enableNotifications();
-            // Use the transport to send a proper JSON-RPC notification
-            transport.sendLog('info', 'MCP fully initialized, notifications enabled');
+            // Flush all deferred messages from both index.ts and server.ts
+            while (deferredMessages.length > 0) {
+                const msg = deferredMessages.shift();
+                transport.sendLog('info', msg.message);
+            }
+            flushDeferredMessages();
+            // Now we can send regular logging messages
+            transport.sendLog('info', 'Server connected successfully');
+            transport.sendLog('info', 'MCP fully initialized, all startup messages sent');
         };
         await server.connect(transport);
-        logToStderr('info', 'Server connected successfully');
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);

package/dist/search-manager.d.ts

@@ -18,6 +18,7 @@ export interface SearchSession {
     buffer: string;
     totalMatches: number;
     totalContextLines: number;
+    wasIncomplete?: boolean;
 }
 export interface SearchSessionOptions {
     rootPath: string;
@@ -64,6 +65,7 @@ export interface SearchSessionOptions {
         error?: string;
         hasMoreResults: boolean;
         runtime: number;
+        wasIncomplete?: boolean;
     };
     /**
      * Terminate a search session (like force_terminate)
@@ -105,4 +107,3 @@ export interface SearchSessionOptions {
     private parseLine;
 }
 export declare const searchManager: SearchManager;
-export declare function stopSearchManagerCleanup(): void;

package/dist/search-manager.js

@@ -120,7 +120,8 @@ import { capture } from './utils/capture.js';
                 isError: session.isError && !!session.error?.trim(), // Only error if we have actual errors
                 error: session.error?.trim() || undefined,
                 hasMoreResults: false, // Tail always returns what's available
-                runtime: Date.now() - session.startTime
+                runtime: Date.now() - session.startTime,
+                wasIncomplete: session.wasIncomplete
             };
         }
         // Handle positive offsets (range behavior) - like file reading
@@ -136,7 +137,8 @@ import { capture } from './utils/capture.js';
             isError: session.isError && !!session.error?.trim(), // Only error if we have actual errors
             error: session.error?.trim() || undefined,
             hasMoreResults,
-            runtime: Date.now() - session.startTime
+            runtime: Date.now() - session.startTime,
+            wasIncomplete: session.wasIncomplete
         };
     }
     /**
@@ -149,7 +151,6 @@ import { capture } from './utils/capture.js';
         }
         if (!session.process.killed) {
             session.process.kill('SIGTERM');
-            capture('search_session_terminated', { sessionId });
         }
         // Don't delete session immediately - let user read final results
         // It will be cleaned up by cleanup process
@@ -178,7 +179,6 @@ import { capture } from './utils/capture.js';
         for (const [sessionId, session] of this.sessions) {
             if (session.isComplete && session.lastReadTime < cutoffTime) {
                 this.sessions.delete(sessionId);
-                capture('search_session_cleaned_up', { sessionId });
             }
         }
     }
@@ -289,6 +289,9 @@ import { capture } from './utils/capture.js';
         });
         process.stderr?.on('data', (data) => {
             const errorText = data.toString();
+            // Store error text for potential user display, but don't capture individual errors
+            // We'll capture incomplete search status in the completion event instead
+            session.error = (session.error || '') + errorText;
             // Filter meaningful errors
             const filteredErrors = errorText
                 .split('\n')
@@ -320,6 +323,11 @@ import { capture } from './utils/capture.js';
                 this.processBufferedOutput(session, true);
             }
             session.isComplete = true;
+            // Track if search was incomplete due to access issues
+            // Ripgrep exit code 2 means "some files couldn't be searched"
+            if (code === 2) {
+                session.wasIncomplete = true;
+            }
             // Only treat as error if:
             // 1. Unexpected exit code (not 0, 1, or 2) AND
             // 2. We have meaningful errors after filtering AND
@@ -340,7 +348,8 @@ import { capture } from './utils/capture.js';
                 exitCode: code,
                 totalResults: session.totalMatches + session.totalContextLines,
                 totalMatches: session.totalMatches,
-                runtime: Date.now() - session.startTime
+                runtime: Date.now() - session.startTime,
+                wasIncomplete: session.wasIncomplete || false // NEW: Track incomplete searches
             });
             // Rely on cleanupSessions(maxAge) only; no per-session timer
         });
@@ -348,10 +357,6 @@ import { capture } from './utils/capture.js';
             session.isComplete = true;
             session.isError = true;
             session.error = `Process error: ${error.message}`;
-            capture('search_session_process_error', {
-                sessionId: session.id,
-                error: error.message
-            });
             // Rely on cleanupSessions(maxAge) only; no per-session timer
         });
     }
@@ -462,10 +467,3 @@ function startCleanupIfNeeded() {
         }, 1000);
     }
 }
-// Export cleanup function for graceful shutdown
-export function stopSearchManagerCleanup() {
-    if (cleanupInterval) {
-        clearInterval(cleanupInterval);
-        cleanupInterval = null;
-    }
-}

package/dist/server.d.ts

@@ -1,4 +1,5 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function flushDeferredMessages(): void;
 export declare const server: Server<{
     method: string;
     params?: {

package/dist/server.js

@@ -18,8 +18,20 @@ import { usageTracker } from './utils/usageTracker.js';
 import { processDockerPrompt } from './utils/dockerPrompt.js';
 import { VERSION } from './version.js';
 import { capture, capture_call_tool } from "./utils/capture.js";
-import { logToStderr } from './utils/logger.js';
-logToStderr('info', 'Loading server.ts');
+import { logToStderr, logger } from './utils/logger.js';
+// Store startup messages to send after initialization
+const deferredMessages = [];
+function deferLog(level, message) {
+    deferredMessages.push({ level, message });
+}
+// Function to flush deferred messages after initialization
+export function flushDeferredMessages() {
+    while (deferredMessages.length > 0) {
+        const msg = deferredMessages.shift();
+        logger.info(msg.message);
+    }
+}
+deferLog('info', 'Loading server.ts');
 export const server = new Server({
     name: "desktop-commander",
     version: VERSION,
@@ -57,8 +69,8 @@ server.setRequestHandler(InitializeRequestSchema, async (request) => {
                 name: clientInfo.name || 'unknown',
                 version: clientInfo.version || 'unknown'
             };
-            // Send JSON-RPC notification about client connection
-            logToStderr('info', `Client connected: ${currentClient.name} v${currentClient.version}`);
+            // Defer client connection message until after initialization
+            deferLog('info', `Client connected: ${currentClient.name} v${currentClient.version}`);
         }
         // Return standard initialization response
         return {
@@ -82,7 +94,7 @@ server.setRequestHandler(InitializeRequestSchema, async (request) => {
 });
 // Export current client info for access by other modules
 export { currentClient };
-logToStderr('info', 'Setting up request handlers...');
+deferLog('info', 'Setting up request handlers...');
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     try {
         logToStderr('debug', 'Generating tools list...');
@@ -105,6 +117,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         - systemInfo (operating system and environment details)
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(GetConfigArgsSchema),
+                    annotations: {
+                        title: "Get Configuration",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "set_config_value",
@@ -127,6 +143,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(SetConfigValueArgsSchema),
+                    annotations: {
+                        title: "Set Configuration Value",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 // Filesystem tools
                 {
@@ -165,6 +187,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ReadFileArgsSchema),
+                    annotations: {
+                        title: "Read File or URL",
+                        readOnlyHint: true,
+                        openWorldHint: true,
+                    },
                 },
                 {
                     name: "read_multiple_files",
@@ -181,6 +208,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ReadMultipleFilesArgsSchema),
+                    annotations: {
+                        title: "Read Multiple Files",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "write_file",
@@ -214,6 +245,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(WriteFileArgsSchema),
+                    annotations: {
+                        title: "Write File",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 {
                     name: "create_directory",
@@ -239,6 +276,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ListDirectoryArgsSchema),
+                    annotations: {
+                        title: "List Directory Contents",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "move_file",
@@ -251,6 +292,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(MoveFileArgsSchema),
+                    annotations: {
+                        title: "Move/Rename File",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 {
                     name: "start_search",
@@ -360,6 +407,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(GetMoreSearchResultsArgsSchema),
+                    annotations: {
+                        title: "Get Search Results",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "stop_search",
@@ -387,6 +438,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ListSearchesArgsSchema),
+                    annotations: {
+                        title: "List Active Searches",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "get_file_info",
@@ -406,6 +461,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(GetFileInfoArgsSchema),
+                    annotations: {
+                        title: "Get File Information",
+                        readOnlyHint: true,
+                    },
                 },
                 // Note: list_allowed_directories removed - use get_config to check allowedDirectories
                 // Text editing tools
@@ -445,6 +504,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(EditBlockArgsSchema),
+                    annotations: {
+                        title: "Edit Text Block",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 // Terminal tools
                 {
@@ -501,6 +566,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         ${PATH_GUIDANCE}
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(StartProcessArgsSchema),
+                    annotations: {
+                        title: "Start Terminal Process",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: true,
+                    },
                 },
                 {
                     name: "read_process_output",
@@ -528,6 +599,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ReadProcessOutputArgsSchema),
+                    annotations: {
+                        title: "Read Process Output",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "interact_with_process",
@@ -580,6 +655,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(InteractWithProcessArgsSchema),
+                    annotations: {
+                        title: "Send Input to Process",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: true,
+                    },
                 },
                 {
                     name: "force_terminate",
@@ -588,6 +669,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ForceTerminateArgsSchema),
+                    annotations: {
+                        title: "Force Terminate Process",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 {
                     name: "list_sessions",
@@ -606,6 +693,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ListSessionsArgsSchema),
+                    annotations: {
+                        title: "List Terminal Sessions",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "list_processes",
@@ -616,6 +707,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(ListProcessesArgsSchema),
+                    annotations: {
+                        title: "List Running Processes",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "kill_process",
@@ -626,6 +721,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(KillProcessArgsSchema),
+                    annotations: {
+                        title: "Kill Process",
+                        readOnlyHint: false,
+                        destructiveHint: true,
+                        openWorldHint: false,
+                    },
                 },
                 {
                     name: "get_usage_stats",
@@ -636,6 +737,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         
                         ${CMD_PREFIX_DESCRIPTION}`,
                     inputSchema: zodToJsonSchema(GetUsageStatsArgsSchema),
+                    annotations: {
+                        title: "Get Usage Statistics",
+                        readOnlyHint: true,
+                    },
                 },
                 {
                     name: "give_feedback_to_desktop_commander",

package/dist/tools/config.js

@@ -14,17 +14,7 @@ export async function getConfig() {
         const configWithSystemInfo = {
             ...config,
             currentClient,
-            systemInfo: {
-                platform: systemInfo.platform,
-                platformName: systemInfo.platformName,
-                defaultShell: systemInfo.defaultShell,
-                pathSeparator: systemInfo.pathSeparator,
-                isWindows: systemInfo.isWindows,
-                isMacOS: systemInfo.isMacOS,
-                isLinux: systemInfo.isLinux,
-                docker: systemInfo.docker,
-                examplePaths: systemInfo.examplePaths
-            }
+            systemInfo
         };
         console.error(`getConfig result: ${JSON.stringify(configWithSystemInfo, null, 2)}`);
         return {

package/dist/types.d.ts

@@ -2,6 +2,7 @@ import { ChildProcess } from 'child_process';
 import { FilteredStdioServerTransport } from './custom-stdio.js';
 declare global {
     var mcpTransport: FilteredStdioServerTransport | undefined;
+    var disableOnboarding: boolean | undefined;
 }
 export interface ProcessInfo {
     pid: number;

package/dist/utils/system-info.d.ts

@@ -29,6 +29,18 @@ export interface SystemInfo {
     isMacOS: boolean;
     isLinux: boolean;
     docker: ContainerInfo;
+    isDXT: boolean;
+    nodeInfo?: {
+        version: string;
+        path: string;
+        npmVersion?: string;
+    };
+    processInfo: {
+        pid: number;
+        arch: string;
+        platform: string;
+        versions: NodeJS.ProcessVersions;
+    };
     examplePaths: {
         home: string;
         temp: string;

package/dist/utils/system-info.js

@@ -305,6 +305,27 @@ function getContainerEnvironment(containerType) {
     }
     return Object.keys(env).length > 0 ? env : undefined;
 }
+/**
+ * Detect Node.js installation and version from current process
+ */
+function detectNodeInfo() {
+    try {
+        // Get Node.js version from current process
+        const version = process.version.replace('v', ''); // Remove 'v' prefix
+        // Get Node.js executable path from current process
+        const path = process.execPath;
+        // Get npm version from environment if available
+        const npmVersion = process.env.npm_version;
+        return {
+            version,
+            path,
+            ...(npmVersion && { npmVersion })
+        };
+    }
+    catch (error) {
+        return undefined;
+    }
+}
 /**
  * Get comprehensive system information for tool prompts
  */
@@ -397,6 +418,15 @@ export function getSystemInfo() {
             examplePaths.accessible = mountPoints.map(mount => mount.containerPath);
         }
     }
+    // Detect Node.js installation from current process
+    const nodeInfo = detectNodeInfo();
+    // Get process information
+    const processInfo = {
+        pid: process.pid,
+        arch: process.arch,
+        platform: process.platform,
+        versions: process.versions
+    };
     return {
         platform,
         platformName,
@@ -415,6 +445,9 @@ export function getSystemInfo() {
             mountPoints,
             containerEnvironment: getContainerEnvironment(containerDetection.containerType)
         },
+        isDXT: !!process.env.MCP_DXT,
+        nodeInfo,
+        processInfo,
         examplePaths
     };
 }
@@ -545,33 +578,51 @@ LINUX-SPECIFIC NOTES:
  * Get common development tool guidance based on OS
  */
 export function getDevelopmentToolGuidance(systemInfo) {
-    const { isWindows, isMacOS, isLinux, platformName } = systemInfo;
+    const { isWindows, isMacOS, isLinux, platformName, nodeInfo, processInfo } = systemInfo;
+    // Add detected Node.js info to guidance
+    const nodeGuidance = nodeInfo
+        ? `Node.js: v${nodeInfo.version} (${nodeInfo.path})${nodeInfo.npmVersion ? ` | npm: v${nodeInfo.npmVersion}` : ''}`
+        : 'Node.js: Not detected';
+    // Add process environment info
+    const envInfo = `
+Current Process Environment:
+- Node: v${processInfo.versions.node}
+- V8: v${processInfo.versions.v8}
+- Architecture: ${processInfo.arch}
+- Platform: ${processInfo.platform}
+- Process ID: ${processInfo.pid}`;
     if (isWindows) {
         return `
 COMMON WINDOWS DEVELOPMENT TOOLS:
-- Node.js: Usually installed globally, accessible from any shell
+- ${nodeGuidance}
 - Python: May be 'python' or 'py' command, check both
 - Git: Git Bash provides Unix-like environment
 - WSL: Windows Subsystem for Linux available for Unix tools
-- Visual Studio tools: cl, msbuild for C++ compilation`;
+- Visual Studio tools: cl, msbuild for C++ compilation
+
+${envInfo}`;
     }
     else if (isMacOS) {
         return `
 COMMON MACOS DEVELOPMENT TOOLS:
 - Xcode Command Line Tools: Required for many development tools
 - Homebrew: Primary package manager for development tools
+- ${nodeGuidance}
 - Python: Usually python3, check if python points to Python 2
-- Node.js: Available via brew or direct installer
-- Ruby: System Ruby available, rbenv/rvm for version management`;
+- Ruby: System Ruby available, rbenv/rvm for version management
+
+${envInfo}`;
     }
     else {
         return `
 COMMON LINUX DEVELOPMENT TOOLS:
 - Package managers: Install tools via distribution package manager
 - Python: Usually python3, python may point to Python 2
-- Node.js: Available via package manager or NodeSource repository
+- ${nodeGuidance}
 - Build tools: gcc, make typically available or easily installed
-- Container tools: docker, podman common for development`;
+- Container tools: docker, podman common for development
+
+${envInfo}`;
     }
 }
 /**

package/dist/utils/usageTracker.js

@@ -299,6 +299,21 @@ class UsageTracker {
      * Check if user should see onboarding invitation - SIMPLE VERSION
      */
     async shouldShowOnboarding() {
+        // Check if onboarding is disabled via command line argument
+        if (global.disableOnboarding) {
+            return false;
+        }
+        // Check if client is desktop-commander (disable for this client)
+        try {
+            const { currentClient } = await import('../server.js');
+            if (currentClient?.name === 'desktop-commander') {
+                return false;
+            }
+        }
+        catch (error) {
+            // If we can't import server, continue with other checks
+            console.log('[ONBOARDING DEBUG] Could not check client name, continuing...');
+        }
         const stats = await this.getStats();
         const onboardingState = await this.getOnboardingState();
         const now = Date.now();

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.2.14";
+export declare const VERSION = "0.2.16";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.2.14';
+export const VERSION = '0.2.16';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wonderwhy-er/desktop-commander",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "description": "MCP server for terminal operations and file editing",
   "mcpName": "io.github.wonderwhy-er/desktop-commander",
   "license": "MIT",
@@ -42,6 +42,7 @@
     "link:local": "npm run build && npm link",
     "unlink:local": "npm unlink",
     "inspector": "npx @modelcontextprotocol/inspector dist/index.js",
+    "build:mcpb": "node scripts/build-mcpb.cjs",
     "logs:view": "npm run build && node scripts/view-fuzzy-logs.js",
     "logs:analyze": "npm run build && node scripts/analyze-fuzzy-logs.js",
     "logs:clear": "npm run build && node scripts/clear-fuzzy-logs.js",