🔥 Critical Windows Hotfix
Fixed Windows npx Installation Failures (#279) [CRITICAL]
This is a critical hotfix for Windows users experiencing installation and connection failures.
Desktop Commander now properly handles npx commands on Windows using the officially recommended cmd /c wrapper pattern. This resolves the widespread connection failures and crashes that occurred when Claude Desktop tried to start the server via npx on Windows.
What Was Broken:
- Windows users experienced "Cannot read properties of undefined (reading 'cmd')" errors
- Server failed to start when installed via npx on Windows
- Claude Desktop showed "Connection closed" or "Cannot connect to MCP server" errors
What's Fixed:
- Windows npx installations now use
cmd /c npxwrapper instead ofnpx.cmd - Debug mode inspector flag (
--inspect-brk) moved toNODE_OPTIONSenvironment variable - Follows Anthropic's official MCP server configuration guidelines for Windows
Impact: Windows users can now successfully install and run Desktop Commander via npx. If you experienced connection issues on Windows, please reinstall:
npx @wonderwhy-er/desktop-commander@latest setup🐛 Additional Bug Fixes
Enhanced Ripgrep Stability (#275)
Improved search functionality reliability with better ripgrep binary management and crash prevention.
What Changed:
- Added verification script to validate ripgrep installation
- Implemented robust binary path resolution system
- Enhanced error handling and crash tracking for search operations
- Removed 283 lines of legacy code for better maintainability
✨ Enhancements
Streamlined Onboarding v2 (#278)
Simplified the new user onboarding experience from multiple steps to just 2 steps with 5 focused prompts, helping new users get started faster.
Release Process Improvements (#280)
Release script now tracks state and can resume from failed steps, making the release workflow more robust and recoverable.