[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73546":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":36,"readmeContent":37,"aiSummary":38,"trendingCount":16,"starSnapshotCount":16,"syncStatus":39,"lastSyncTime":40,"discoverSource":41},73546,"DesktopCommanderMCP","wonderwhy-er\u002FDesktopCommanderMCP","wonderwhy-er","This is MCP server for Claude that gives it terminal control, file system search and diff file editing capabilities","https:\u002F\u002Fdesktopcommander.app\u002F",null,"TypeScript",6151,725,43,114,0,34,59,123,102,114.58,"MIT License",false,"main",true,[27,28,29,30,31,32,33,34,35],"agent","ai","code-analysis","code-generation","gemini-cli-extension","mcp","terminal-ai","terminal-automation","vibe-coding","2026-06-12 04:01:09","# Desktop Commander MCP\n### Search, update, manage files and run terminal commands with AI\n\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdw\u002F@wonderwhy-er\u002Fdesktop-commander)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@wonderwhy-er\u002Fdesktop-commander)\n[![AgentAudit Verified](https:\u002F\u002Fagentaudit.dev\u002Fapi\u002Fbadge\u002Fdesktop-commander)](https:\u002F\u002Fagentaudit.dev\u002Fskills\u002Fdesktop-commander)\n[![Trust Score](https:\u002F\u002Farchestra.ai\u002Fmcp-catalog\u002Fapi\u002Fbadge\u002Fquality\u002Fwonderwhy-er\u002FDesktopCommanderMCP)](https:\u002F\u002Farchestra.ai\u002Fmcp-catalog\u002Fwonderwhy-er__desktopcommandermcp)\n[![smithery badge](https:\u002F\u002Fsmithery.ai\u002Fbadge\u002F@wonderwhy-er\u002Fdesktop-commander)](https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@wonderwhy-er\u002Fdesktop-commander)\n[![Buy Me A Coffee](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBuy%20Me%20A%20Coffee-support-yellow.svg)](https:\u002F\u002Fwww.buymeacoffee.com\u002Fwonderwhyer)\n\n\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJoin%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002FkQ27sNnZr7)\n\n\nWork with code and text, run processes, and automate tasks, going far beyond other AI editors - while using host client subscriptions instead of API token costs.\n\n\u003Ca href=\"https:\u002F\u002Fglama.ai\u002Fmcp\u002Fservers\u002Fzempur9oh4\">\n  \u003Cimg width=\"380\" height=\"200\" src=\"https:\u002F\u002Fglama.ai\u002Fmcp\u002Fservers\u002Fzempur9oh4\u002Fbadge\" alt=\"Desktop Commander MCP\" \u002F>\n\u003C\u002Fa>\n\n## 👋 We’re hiring — come build with us: https:\u002F\u002Fdesktopcommander.app\u002Fcareers\u002F\n\n## 🖥️ Try the Desktop Commander App (Beta)\n\n**Want a better experience?** The Desktop Commander App gives you everything the MCP server does, plus:\n\n- **Use any AI model** — Claude, GPT-4.5, Gemini 2.5, or any model you prefer\n- **See file changes live** — visual file previews as AI edits your files\n- **Add custom MCPs and context** — extend with your own tools, no config files\n- **Coming soon** — skills system, dictation, background scheduled tasks, and more\n\n**👉 [Download the App](https:\u002F\u002Fdesktopcommander.app\u002F#download)** (macOS & Windows)\n\n> The MCP server below still works great with Claude Desktop and other MCP clients — the app is for those who want a dedicated, polished experience.\n\n## Table of Contents\n- [Features](#features)\n- [How to install](#how-to-install)\n- [Getting Started](#getting-started)\n- [Usage](#usage)\n- [File Preview UI & Markdown Editor](#file-preview-ui--markdown-editor)\n- [Handling Long-Running Commands](#handling-long-running-commands)\n- [Work in Progress and TODOs](#roadmap)\n- [Sponsors and Supporters](#support-desktop-commander)\n- [Website](#website)\n- [Media](#media)\n- [Testimonials](#testimonials)\n- [Frequently Asked Questions](#frequently-asked-questions)\n- [Contributing](#contributing)\n- [License](#license)\n\nAll of your AI development tools in one place.\nDesktop Commander puts all dev tools in one chat.\nExecute long-running terminal commands on your computer and manage processes through Model Context Protocol (MCP). Built on top of [MCP Filesystem Server](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Fservers\u002Ftree\u002Fmain\u002Fsrc\u002Ffilesystem) to provide additional search and replace file editing capabilities.\n\n## Features\n\n- **Remote AI Control** - Use Desktop Commander from ChatGPT, Claude web, and other AI services via [Remote MCP](https:\u002F\u002Fmcp.desktopcommander.app)\n- **File Preview UI** - Visual file previews in Claude Desktop with rendered markdown, inline images, expandable content, built-in markdown editor, and quick \"Open in folder\" access\n- **Enhanced terminal commands with interactive process control**\n- **Execute code in memory (Python, Node.js, R) without saving files**\n- **Instant data analysis - just ask to analyze CSV\u002FJSON\u002FExcel files**\n- **Native Excel file support** - Read, write, edit, and search Excel files (.xlsx, .xls, .xlsm) without external tools\n- **PDF support** - Read PDFs with text extraction, create new PDFs from markdown, modify existing PDFs\n- **DOCX support** - Read, create, edit, and search Word documents (.docx) with surgical XML editing and markdown-to-DOCX conversion\n- **Interact with running processes (SSH, databases, development servers)**\n- Execute terminal commands with output streaming\n- Command timeout and background execution support\n- Process management (list and kill processes)\n- Session management for long-running commands\n- **Process output pagination** - Read terminal output with offset\u002Flength controls to prevent context overflow\n- Server configuration management:\n  - Get\u002Fset configuration values\n  - Update multiple settings at once\n  - Dynamic configuration changes without server restart\n- Full filesystem operations:\n  - Read\u002Fwrite files (text, Excel, PDF, DOCX)\n  - Create\u002Flist directories\n  - **Recursive directory listing** with configurable depth and context overflow protection for large folders\n  - Move files\u002Fdirectories\n  - Search files and content (including Excel content)\n  - Get file metadata\n  - **Negative offset file reading**: Read from end of files using negative offset values (like Unix tail)\n- Code editing capabilities:\n  - Surgical text replacements for small changes\n  - Full file rewrites for major changes\n  - Multiple file support\n  - Pattern-based replacements\n  - vscode-ripgrep based recursive code or text search in folders\n- Comprehensive audit logging:\n  - All tool calls are automatically logged\n  - Log rotation with 10MB size limit\n  - Detailed timestamps and arguments\n- Security hardening:\n  - Symlink traversal prevention on file operations\n  - Command blocklist with bypass protection\n  - [Docker isolation](#option-6-docker-installation--auto-updates-no-nodejs-required) for full sandboxing\n  - See [SECURITY.md](SECURITY.md) for details\n\n## How to install\n\n### Install in Claude Desktop\n\nDesktop Commander offers multiple installation methods for Claude Desktop.\n\n> **📋 Update & Uninstall Information:** Options 1, 2, 3, 4, and 6 have automatic updates. Option 5 requires manual updates. See below for details.\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Option 1: Install through npx ⭐ Auto-Updates (Requires Node.js)\u003C\u002Fb>\u003C\u002Fsummary>\n\nJust run this in terminal:\n```\nnpx @wonderwhy-er\u002Fdesktop-commander@latest setup\n```\n\nFor debugging mode (allows Node.js inspector connection):\n```\nnpx @wonderwhy-er\u002Fdesktop-commander@latest setup --debug\n```\n\n**Command line options during setup:**\n- `--debug`: Enable debugging mode for Node.js inspector\n- `--no-onboarding`: Disable onboarding prompts for new users\n\nRestart Claude if running.\n\n**✅ Auto-Updates:** Yes - automatically updates when you restart Claude  \n**🔄 Manual Update:** Run the setup command again  \n**🗑️ Uninstall:** Run `npx @wonderwhy-er\u002Fdesktop-commander@latest remove`\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Option 2: Using bash script installer (macOS) ⭐ Auto-Updates (Installs Node.js if needed)\u003C\u002Fb>\u003C\u002Fsummary>\n\n```\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Frefs\u002Fheads\u002Fmain\u002Finstall.sh | bash\n```\nThis script handles all dependencies and configuration automatically.\n\n**✅ Auto-Updates:** Yes  \n**🔄 Manual Update:** Re-run the bash installer command above  \n**🗑️ Uninstall:** Run `npx @wonderwhy-er\u002Fdesktop-commander@latest remove`\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Option 3: Installing via Smithery ⭐ Auto-Updates (Requires Node.js)\u003C\u002Fb>\u003C\u002Fsummary>\n\n1. **Visit:** https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@wonderwhy-er\u002Fdesktop-commander\n2. **Login to Smithery** if you haven't already\n3. **Select your client** (Claude Desktop) on the right side\n4. **Install with the provided key** that appears after selecting your client\n5. **Restart Claude Desktop**\n\n**✅ Auto-Updates:** Yes - automatically updates when you restart Claude  \n**🔄 Manual Update:** Visit the Smithery page and reinstall  \n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Option 4: Add to claude_desktop_config manually ⭐ Auto-Updates (Requires Node.js)\u003C\u002Fb>\u003C\u002Fsummary>\n\nAdd this entry to your claude_desktop_config.json:\n\n- On Mac: `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n- On Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- On Linux: `~\u002F.config\u002FClaude\u002Fclaude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"desktop-commander\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@wonderwhy-er\u002Fdesktop-commander@latest\"\n      ]\n    }\n  }\n}\n```\nRestart Claude if running.\n\n**✅ Auto-Updates:** Yes - automatically updates when you restart Claude  \n**🔄 Manual Update:** Run the setup command again  \n**🗑️ Uninstall:** Run `npx @wonderwhy-er\u002Fdesktop-commander@latest remove` or remove the entry from your claude_desktop_config.json\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Option 5: Checkout locally ❌ Manual Updates (Requires Node.js)\u003C\u002Fb>\u003C\u002Fsummary>\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP.git\ncd DesktopCommanderMCP\nnpm run setup\n```\nRestart Claude if running.\n\nThe setup command will install dependencies, build the server, and configure Claude's desktop app.\n\n**❌ Auto-Updates:** No - requires manual git updates  \n**🔄 Manual Update:** `cd DesktopCommanderMCP && git pull && npm run setup`  \n**🗑️ Uninstall:** Run `npx @wonderwhy-er\u002Fdesktop-commander@latest remove` or remove the cloned directory and MCP server entry from Claude config\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Option 6: Docker Installation 🐳 ⭐ Auto-Updates (No Node.js Required)\u003C\u002Fb>\u003C\u002Fsummary>\n\nPerfect for users who want isolation or don't have Node.js installed. Runs in a sandboxed Docker container with a persistent work environment.\n\n**Prerequisites:** [Docker Desktop](https:\u002F\u002Fwww.docker.com\u002Fproducts\u002Fdocker-desktop\u002F) installed **and running**, Claude Desktop app installed.\n\n**macOS\u002FLinux:**\n```bash\nbash \u003C(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Frefs\u002Fheads\u002Fmain\u002Finstall-docker.sh)\n```\n\n**Windows PowerShell:**\n```powershell\niex ((New-Object System.Net.WebClient).DownloadString('https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Frefs\u002Fheads\u002Fmain\u002Finstall-docker.ps1'))\n```\n\nThe installer will check Docker, pull the image, prompt for folder mounting, and configure Claude Desktop.\n\n**Docker persistence:** Your tools, configs, work files, and package caches all survive restarts.\n\n\u003Cdetails>\n\u003Csummary>Manual Docker Configuration\u003C\u002Fsummary>\n\n**Basic setup (no file access):**\n```json\n{\n  \"mcpServers\": {\n    \"desktop-commander-in-docker\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"mcp\u002Fdesktop-commander:latest\"]\n    }\n  }\n}\n```\n\n**With folder mounting:**\n```json\n{\n  \"mcpServers\": {\n    \"desktop-commander-in-docker\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-v\", \"\u002FUsers\u002Fusername\u002FDesktop:\u002Fmnt\u002Fdesktop\",\n        \"-v\", \"\u002FUsers\u002Fusername\u002FDocuments:\u002Fmnt\u002Fdocuments\",\n        \"mcp\u002Fdesktop-commander:latest\"\n      ]\n    }\n  }\n}\n```\n\n**Advanced folder mounting:**\n```json\n{\n  \"mcpServers\": {\n    \"desktop-commander-in-docker\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-v\", \"dc-system:\u002Fusr\",\n        \"-v\", \"dc-home:\u002Froot\", \n        \"-v\", \"dc-workspace:\u002Fworkspace\",\n        \"-v\", \"dc-packages:\u002Fvar\",\n        \"-v\", \"\u002FUsers\u002Fusername\u002FProjects:\u002Fmnt\u002FProjects\",\n        \"-v\", \"\u002FUsers\u002Fusername\u002FDownloads:\u002Fmnt\u002FDownloads\",\n        \"mcp\u002Fdesktop-commander:latest\"\n      ]\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Docker Management Commands\u003C\u002Fsummary>\n\n**macOS\u002FLinux:**\n```bash\n# Check status\nbash \u003C(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Frefs\u002Fheads\u002Fmain\u002Finstall-docker.sh) --status\n\n# Reset all persistent data\nbash \u003C(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Frefs\u002Fheads\u002Fmain\u002Finstall-docker.sh) --reset\n```\n\n**Windows PowerShell:**\n```powershell\n# Check status\n$script = (New-Object System.Net.WebClient).DownloadString('https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Frefs\u002Fheads\u002Fmain\u002Finstall-docker.ps1'); & ([ScriptBlock]::Create(\"$script\")) -Status\n\n# Reset all data\n$script = (New-Object System.Net.WebClient).DownloadString('https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Frefs\u002Fheads\u002Fmain\u002Finstall-docker.ps1'); & ([ScriptBlock]::Create(\"$script\")) -Reset\n\n# Show help\n$script = (New-Object System.Net.WebClient).DownloadString('https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Frefs\u002Fheads\u002Fmain\u002Finstall-docker.ps1'); & ([ScriptBlock]::Create(\"$script\")) -Help\n```\n\n**Troubleshooting:** Reset and reinstall from scratch:\n```bash\nbash \u003C(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Frefs\u002Fheads\u002Fmain\u002Finstall-docker.sh) --reset && bash \u003C(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Frefs\u002Fheads\u002Fmain\u002Finstall-docker.sh)\n```\n\n\u003C\u002Fdetails>\n\n**✅ Auto-Updates:** Yes - `latest` tag automatically gets newer versions  \n**🔄 Manual Update:** `docker pull mcp\u002Fdesktop-commander:latest` then restart Claude  \n\n\u003C\u002Fdetails>\n\n### Install in Other Clients\n\nDesktop Commander works with any MCP-compatible client. The standard JSON configuration is:\n\n```json\n{\n  \"mcpServers\": {\n    \"desktop-commander\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@wonderwhy-er\u002Fdesktop-commander@latest\"]\n    }\n  }\n}\n```\n\nAdd this to your client's MCP configuration file at the locations below:\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Cursor\u003C\u002Fb>\u003C\u002Fsummary>\u003Cbr>\n\n[![Install MCP Server](https:\u002F\u002Fcursor.com\u002Fdeeplink\u002Fmcp-install-dark.svg)](https:\u002F\u002Fcursor.com\u002Fen-US\u002Finstall-mcp?name=desktop-commander&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB3b25kZXJ3aHktZXIvZGVza3RvcC1jb21tYW5kZXJAbGF0ZXN0Il19)\n\n[View MCP Server in Directory](https:\u002F\u002Fcursor.directory\u002Fmcp\u002Fdesktop-commander-mcp)\n\nOr add manually to `~\u002F.cursor\u002Fmcp.json` (global) or `.cursor\u002Fmcp.json` in your project folder (project-specific).\n\nSee [Cursor MCP docs](https:\u002F\u002Fdocs.cursor.com\u002Fcontext\u002Fmodel-context-protocol) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Windsurf\u003C\u002Fb>\u003C\u002Fsummary>\n\nAdd to `~\u002F.codeium\u002Fwindsurf\u002Fmcp_config.json`. See [Windsurf MCP docs](https:\u002F\u002Fdocs.windsurf.com\u002Fwindsurf\u002Fcascade\u002Fmcp) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>VS Code \u002F GitHub Copilot\u003C\u002Fb>\u003C\u002Fsummary>\n\nAdd to `.vscode\u002Fmcp.json` in your project or VS Code User Settings (JSON). Make sure MCP is enabled under Chat > MCP. Works in Agent mode.\n\nSee [VS Code MCP docs](https:\u002F\u002Fcode.visualstudio.com\u002Fdocs\u002Fcopilot\u002Fchat\u002Fmcp-servers) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Cline\u003C\u002Fb>\u003C\u002Fsummary>\n\nConfigure through the Cline extension settings in VS Code. Open the Cline sidebar, click the MCP Servers icon, and add the JSON configuration above. See [Cline MCP docs](https:\u002F\u002Fdocs.cline.bot\u002Fmcp\u002Fconfiguring-mcp-servers) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Roo Code\u003C\u002Fb>\u003C\u002Fsummary>\n\nAdd to your Roo Code MCP configuration file. See [Roo Code MCP docs](https:\u002F\u002Fdocs.roocode.com\u002Ffeatures\u002Fmcp\u002Fusing-mcp-in-roo) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Claude Code\u003C\u002Fb>\u003C\u002Fsummary>\n\n```sh\nclaude mcp add --scope user desktop-commander -- npx -y @wonderwhy-er\u002Fdesktop-commander@latest\n```\n\nRemove `--scope user` to install for the current project only. See [Claude Code MCP docs](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fmcp) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Trae\u003C\u002Fb>\u003C\u002Fsummary>\n\nUse the \"Add manually\" feature and paste the JSON configuration above. See [Trae MCP docs](https:\u002F\u002Fdocs.trae.ai\u002Fide\u002Fmodel-context-protocol?_lang=en) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Kiro\u003C\u002Fb>\u003C\u002Fsummary>\n\nNavigate to `Kiro` > `MCP Servers`, click `+ Add`, and paste the JSON configuration above. See [Kiro MCP docs](https:\u002F\u002Fkiro.dev\u002Fdocs\u002Fmcp\u002Fconfiguration\u002F) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Codex (OpenAI)\u003C\u002Fb>\u003C\u002Fsummary>\n\nCodex uses TOML configuration. Run this command to add Desktop Commander:\n\n```sh\ncodex mcp add desktop-commander -- npx -y @wonderwhy-er\u002Fdesktop-commander@latest\n```\n\nOr manually add to `~\u002F.codex\u002Fconfig.toml`:\n\n```toml\n[mcp_servers.desktop-commander]\ncommand = \"npx\"\nargs = [\"-y\", \"@wonderwhy-er\u002Fdesktop-commander@latest\"]\n```\n\nSee [Codex MCP docs](https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fmcp\u002F) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>JetBrains (AI Assistant)\u003C\u002Fb>\u003C\u002Fsummary>\n\nIn JetBrains IDEs, go to **Settings → Tools → AI Assistant → Model Context Protocol (MCP)**, click `+` Add, select **As JSON**, and paste the JSON configuration above. See [JetBrains MCP docs](https:\u002F\u002Fwww.jetbrains.com\u002Fhelp\u002Fai-assistant\u002Fconfigure-an-mcp-server.html) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Gemini CLI\u003C\u002Fb>\u003C\u002Fsummary>\n\nAdd to `~\u002F.gemini\u002Fsettings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"desktop-commander\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@wonderwhy-er\u002Fdesktop-commander@latest\"]\n    }\n  }\n}\n```\n\nSee [Gemini CLI docs](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Augment Code\u003C\u002Fb>\u003C\u002Fsummary>\n\nPress `Cmd\u002FCtrl+Shift+P`, open the Augment panel, and add a new MCP server named `desktop-commander` with the JSON configuration above. See [Augment Code MCP docs](https:\u002F\u002Fdocs.augmentcode.com\u002Fsetup-augment\u002Fmcp) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Qwen Code\u003C\u002Fb>\u003C\u002Fsummary>\n\nRun this command to add Desktop Commander:\n\n```sh\nqwen mcp add desktop-commander -- npx -y @wonderwhy-er\u002Fdesktop-commander@latest\n```\n\nOr add to `.qwen\u002Fsettings.json` (project) or `~\u002F.qwen\u002Fsettings.json` (global). See [Qwen Code MCP docs](https:\u002F\u002Fqwenlm.github.io\u002Fqwen-code-docs\u002Fen\u002Fdevelopers\u002Ftools\u002Fmcp-server\u002F) for more info.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>ChatGPT \u002F Claude Web (Remote MCP)\u003C\u002Fb>\u003C\u002Fsummary>\n\nUse Desktop Commander from **ChatGPT**, **Claude web**, and other AI services via Remote MCP — no desktop app required.\n\n**👉 [Get started at mcp.desktopcommander.app](https:\u002F\u002Fmcp.desktopcommander.app)**\n\nHow it works:\n1. You run a lightweight **Remote Device** on your computer\n2. It connects securely to the cloud Remote MCP service\n3. Your AI sends commands through the cloud to your device\n4. Commands execute locally, results return to your AI\n5. **You stay in control** — stop anytime with `Ctrl+C`\n\n### Security\n\n- ✅ Device only runs when you start it\n- ✅ Commands execute under your user permissions\n- ✅ Secure OAuth authentication and encrypted communication channel\n\n\u003C\u002Fdetails>\n\n## Updating & Uninstalling Desktop Commander\n\n### Automatic Updates (Options 1, 2, 3, 4 & 6)\n**Options 1 (npx), Option 2 (bash installer), 3 (Smithery), 4 (manual config), and 6 (Docker)** automatically update to the latest version whenever you restart Claude. No manual intervention needed.\n\n### Manual Updates (Option 5)\n- **Option 5 (local checkout):** `cd DesktopCommanderMCP && git pull && npm run setup`\n\n### Uninstalling Desktop Commander\n#### 🤖 Automatic Uninstallation (Recommended)\n\nThe easiest way to completely remove Desktop Commander:\n\n```bash\nnpx @wonderwhy-er\u002Fdesktop-commander@latest remove\n```\n\nThis automatic uninstaller will:\n- ✅ Remove Desktop Commander from Claude's MCP server configuration\n- ✅ Create a backup of your Claude config before making changes\n- ✅ Provide guidance for complete package removal\n- ✅ Restore from backup if anything goes wrong\n\n#### 🔧 Manual Uninstallation\n\nIf the automatic uninstaller doesn't work or you prefer manual removal:\n\n##### Remove from Claude Configuration\n\n1. **Locate your Claude Desktop config file:**\n  - **macOS:** `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`\n  - **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n  - **Linux:** `~\u002F.config\u002FClaude\u002Fclaude_desktop_config.json`\n\n2. **Edit the config file:**\n  - Open the file in a text editor\n  - Find and remove the `\"desktop-commander\"` entry from the `\"mcpServers\"` section\n  - Save the file\n\n  **Example - Remove this section:**\n  ```json\n  {\n      \"desktop-commander\": {\n        \"command\": \"npx\",\n        \"args\": [\"@wonderwhy-er\u002Fdesktop-commander@latest\"]\n      }\n  }\n  ```\n\nClose and restart Claude Desktop to complete the removal.\n\n#### 🆘 Troubleshooting\n\n**If automatic uninstallation fails:**\n- Use manual uninstallation as a fallback\n\n**If Claude won't start after uninstalling:**\n- Restore the backup config file created by the uninstaller\n- Or manually fix the JSON syntax in your claude_desktop_config.json\n\n**Need help?**\n- Join our Discord community: https:\u002F\u002Fdiscord.com\u002Finvite\u002FkQ27sNnZr7\n\n## Getting Started\n\nOnce Desktop Commander is installed and Claude Desktop is restarted, you're ready to supercharge your Claude experience!\n\n### 🚀 New User Onboarding\n\nDesktop Commander includes intelligent onboarding to help you discover what's possible:\n\n**For New Users:** When you're just getting started (fewer than 10 successful commands), Claude will automatically offer helpful getting-started guidance and practical tutorials after you use Desktop Commander successfully.\n\n**Request Help Anytime:** You can ask for onboarding assistance at any time by simply saying:\n- *\"Help me get started with Desktop Commander\"*\n- *\"Show me Desktop Commander examples\"* \n- *\"What can I do with Desktop Commander?\"*\n\nClaude will then show you beginner-friendly tutorials and examples, including:\n- 📁 Organizing your Downloads folder automatically\n- 📊 Analyzing CSV\u002FExcel files with Python\n- ⚙️ Setting up GitHub Actions CI\u002FCD\n- 🔍 Exploring and understanding codebases\n- 🤖 Running interactive development environments\n\n## Usage\n\nThe server provides a comprehensive set of tools organized into several categories:\n\n### Available Tools\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| **Configuration** | `get_config` | Get the complete server configuration as JSON (includes blockedCommands, defaultShell, allowedDirectories, fileReadLineLimit, fileWriteLineLimit, telemetryEnabled) |\n| | `set_config_value` | Set a specific configuration value by key. Available settings: \u003Cbr>• `blockedCommands`: Array of shell commands that cannot be executed\u003Cbr>• `defaultShell`: Shell to use for commands (e.g., bash, zsh, powershell)\u003Cbr>• `allowedDirectories`: Array of filesystem paths the server can access for file operations (⚠️ terminal commands can still access files outside these directories)\u003Cbr>• `fileReadLineLimit`: Maximum lines to read at once (default: 1000)\u003Cbr>• `fileWriteLineLimit`: Maximum lines to write at once (default: 50)\u003Cbr>• `telemetryEnabled`: Enable\u002Fdisable telemetry (boolean) |\n| **Terminal** | `start_process` | Start programs with smart detection of when they're ready for input |\n| | `interact_with_process` | Send commands to running programs and get responses |\n| | `read_process_output` | Read output from running processes |\n| | `force_terminate` | Force terminate a running terminal session |\n| | `list_sessions` | List all active terminal sessions |\n| | `list_processes` | List all running processes with detailed information |\n| | `kill_process` | Terminate a running process by PID |\n| **Filesystem** | `read_file` | Read contents from local filesystem, URLs, Excel files (.xlsx, .xls, .xlsm), and PDFs with line\u002Fpage-based pagination |\n| | `read_multiple_files` | Read multiple files simultaneously |\n| | `write_file` | Write file contents with options for rewrite or append mode. Supports Excel files (JSON 2D array format). For PDFs, use `write_pdf` |\n| | `write_pdf` | Create new PDF files from markdown or modify existing PDFs (insert\u002Fdelete pages). Supports HTML\u002FCSS styling and SVG graphics |\n| | `create_directory` | Create a new directory or ensure it exists |\n| | `list_directory` | Get detailed recursive listing of files and directories (supports depth parameter, default depth=2) |\n| | `move_file` | Move or rename files and directories |\n| | `start_search` | Start streaming search for files by name or content patterns (searches text files and Excel content) |\n| | `get_more_search_results` | Get paginated results from active search with offset support |\n| | `stop_search` | Stop an active search gracefully |\n| | `list_searches` | List all active search sessions |\n| | `get_file_info` | Retrieve detailed metadata about a file or directory (includes sheet info for Excel files) |\n| **Text Editing** | `edit_block` | Apply targeted text replacements for text files, or range-based cell updates for Excel files |\n| **Analytics** | `get_usage_stats` | Get usage statistics for your own insight |\n| | `get_recent_tool_calls` | Get recent tool call history with arguments and outputs for debugging and context recovery |\n| | `give_feedback_to_desktop_commander` | Open feedback form in browser to provide feedback to Desktop Commander Team |\n\n### Quick Examples\n\n**Data Analysis:**\n```\n\"Analyze sales.csv and show top customers\" → Claude runs Python code in memory\n```\n\n**Remote Access:**\n```\n\"SSH to my server and check disk space\" → Claude maintains SSH session\n```\n\n**Development:**\n```\n\"Start Node.js and test this API\" → Claude runs interactive Node session\n```\n\n### Tool Usage Examples\n\nSearch\u002FReplace Block Format:\n```\nfilepath.ext\n\u003C\u003C\u003C\u003C\u003C\u003C\u003C SEARCH\ncontent to find\n=======\nnew content\n>>>>>>> REPLACE\n```\n\nExample:\n```\nsrc\u002Fmain.js\n\u003C\u003C\u003C\u003C\u003C\u003C\u003C SEARCH\nconsole.log(\"old message\");\n=======\nconsole.log(\"new message\");\n>>>>>>> REPLACE\n```\n\n### Enhanced Edit Block Features\n\nThe `edit_block` tool includes several enhancements for better reliability:\n\n1. **Improved Prompting**: Tool descriptions now emphasize making multiple small, focused edits rather than one large change\n2. **Fuzzy Search Fallback**: When exact matches fail, it performs fuzzy search and provides detailed feedback\n3. **Character-level Diffs**: Shows exactly what's different using `{-removed-}{+added+}` format\n4. **Multiple Occurrence Support**: Can replace multiple instances with `expected_replacements` parameter\n5. **Comprehensive Logging**: All fuzzy searches are logged for analysis and debugging\n\nWhen a search fails, you'll see detailed information about the closest match found, including similarity percentage, execution time, and character differences. All these details are automatically logged for later analysis using the fuzzy search log tools.\n\n### Docker Support\n\n### 🐳 Isolated Environment Usage\n\nDesktop Commander can be run in Docker containers for **complete isolation from your host system**, providing **zero risk to your computer**. This is perfect for testing, development, or when you want complete sandboxing.\n\n### Installation Instructions\n\n1. **Install Docker for Windows\u002FMac**\n   - Download and install Docker Desktop from [docker.com](https:\u002F\u002Fwww.docker.com\u002Fproducts\u002Fdocker-desktop\u002F)\n\n2. **Get Desktop Commander Docker Configuration**\n   - Visit: https:\u002F\u002Fhub.docker.com\u002Fmcp\u002Fserver\u002Fdesktop-commander\u002Fmanual\n   - **Option A:** Use the provided terminal command for automated setup\n   - **Option B:** Click \"Standalone\" to get the config JSON and add it manually to your Claude Desktop config\n ![docker-config.png](screenshots\u002Fdocker-config.png)\n\n3. **Mount Your Machine Folders (Coming Soon)**\n   - Instructions on how to mount your local directories into the Docker container will be provided soon\n   - This will allow you to work with your files while maintaining complete isolation\n\n### Benefits of Docker Usage\n- **Complete isolation** from your host system\n- **Consistent environment** across different machines\n- **Easy cleanup** - just remove the container when done\n- **Perfect for testing** new features or configurations\n\n## URL Support\n- `read_file` can now fetch content from both local files and URLs\n- Example: `read_file` with `isUrl: true` parameter to read from web resources\n- Handles both text and image content from remote sources\n- Images (local or from URLs) are displayed visually in Claude's interface, not as text\n- Claude can see and analyze the actual image content\n- Default 30-second timeout for URL requests\n\n## File Preview UI & Markdown Editor\n\nDesktop Commander includes a rich file preview widget in Claude Desktop that renders files visually as AI works with them.\n\n### Supported file types\n- **Markdown** — rendered preview with a built-in editor\n- **Images** — inline display (PNG, JPEG, GIF, WebP, etc.)\n- **Code files** — syntax-highlighted source view\n- **HTML** — rendered preview with toggle to source view\n- **Directories** — interactive tree with expand\u002Fcollapse and lazy loading\n- **PDF, Excel, DOCX** — native content extraction and display\n\n### Markdown Editor\n\nWhen viewing a `.md` file in Claude Desktop, you can edit it directly inside the preview panel — no need to open a separate app.\n\n**How to use:**\n1. Ask Claude to read or create a markdown file\n2. Expand the file preview to fullscreen using the **⤢ Expand** button\n3. The editor activates automatically in fullscreen mode\n4. Edit your content with a live preview toggle, copy, undo, and save controls\n5. Changes are saved back to disk; collapse to return to inline view\n\n**Editor features:**\n- Live **edit \u002F preview toggle** — switch between raw markdown and rendered output\n- **Auto-save** to disk with save status indicator\n- **Undo** support to revert unsaved changes\n- **Copy** button to grab the full markdown source\n- **Open in editor** — launch your default markdown app directly from the panel\n- Partial-file awareness — loads and merges surrounding lines when the file was only partially read\n- Text selection context — select text in preview mode and the AI can reference your selection\n\n### Directory Browser\n\nWhen Claude runs `list_directory`, the result opens as an interactive file tree inside the preview panel — not just raw text output.\n\n**Features:**\n- **Expandable tree** — folders expand and collapse on click; top-level contents shown immediately\n- **Lazy loading** — subfolders load on demand to keep the initial view fast\n- **Large directory handling** — directories with many items show a `⚠ click to load all` button instead of overwhelming the view\n- **Open in Finder\u002FExplorer** — each folder has a quick-open button to reveal it in your file manager\n- **Click to preview** — clicking any file in the tree opens it in the file preview panel directly\n- **Back navigation** — after opening a file from the tree, a ← Back button returns you to the directory view\n\n### Other preview features\n- **Expand \u002F collapse** — toggle between compact summary row and full panel\n- **Open in folder** — reveal the file in Finder\u002FExplorer with one click\n- **Load more lines** — incrementally load content above or below a partial read window\n- **Text selection** — highlight text in any preview; the AI can see and reference your selection\n\n## Fuzzy Search Log Analysis (npm scripts)\n\nThe fuzzy search logging system includes convenient npm scripts for analyzing logs outside of the MCP environment:\n\n```bash\n# View recent fuzzy search logs\nnpm run logs:view -- --count 20\n\n# Analyze patterns and performance\nnpm run logs:analyze -- --threshold 0.8\n\n# Export logs to CSV or JSON\nnpm run logs:export -- --format json --output analysis.json\n\n# Clear all logs (with confirmation)\nnpm run logs:clear\n```\n\nFor detailed documentation on these scripts, see [scripts\u002FREADME.md](scripts\u002FREADME.md).\n\n## Fuzzy Search Logs\n\nDesktop Commander includes comprehensive logging for fuzzy search operations in the `edit_block` tool. When an exact match isn't found, the system performs a fuzzy search and logs detailed information for analysis.\n\n### What Gets Logged\n\nEvery fuzzy search operation logs:\n- **Search and found text**: The text you're looking for vs. what was found\n- **Similarity score**: How close the match is (0-100%)\n- **Execution time**: How long the search took\n- **Character differences**: Detailed diff showing exactly what's different\n- **File metadata**: Extension, search\u002Ffound text lengths\n- **Character codes**: Specific character codes causing differences\n\n### Log Location\n\nLogs are automatically saved to:\n- **macOS\u002FLinux**: `~\u002F.claude-server-commander-logs\u002Ffuzzy-search.log`\n- **Windows**: `%USERPROFILE%\\.claude-server-commander-logs\\fuzzy-search.log`\n\n### What You'll Learn\n\nThe fuzzy search logs help you understand:\n1. **Why exact matches fail**: Common issues like whitespace differences, line endings, or character encoding\n2. **Performance patterns**: How search complexity affects execution time\n3. **File type issues**: Which file extensions commonly have matching problems\n4. **Character encoding problems**: Specific character codes that cause diffs\n\n## Audit Logging\n\nDesktop Commander now includes comprehensive logging for all tool calls:\n\n### What Gets Logged\n- Every tool call is logged with timestamp, tool name, and arguments (sanitized for privacy)\n- Logs are rotated automatically when they reach 10MB in size\n\n### Log Location\nLogs are saved to:\n- **macOS\u002FLinux**: `~\u002F.claude-server-commander\u002Fclaude_tool_call.log`\n- **Windows**: `%USERPROFILE%\\.claude-server-commander\\claude_tool_call.log`\n\nThis audit trail helps with debugging, security monitoring, and understanding how Claude is interacting with your system.\n\n## Handling Long-Running Commands\n\nFor commands that may take a while:\n\n## Configuration Management\n\n### ⚠️ Important Security Warnings\n\n> **For comprehensive security information and vulnerability reporting**: See [SECURITY.md](SECURITY.md)\n\n1. **Known security limitations**: Directory restrictions and command blocking can be bypassed through various methods including symlinks, command substitution, and absolute paths or code execution\n\n2. **Always change configuration in a separate chat window** from where you're doing your actual work. Claude may sometimes attempt to modify configuration settings (like `allowedDirectories`) if it encounters filesystem access restrictions.\n\n3. **The `allowedDirectories` setting currently only restricts filesystem operations**, not terminal commands. Terminal commands can still access files outside allowed directories.\n\n4. **For production security**: Use the [Docker installation](#option-6-docker-installation-🐳-⭐-auto-updates-no-nodejs-required) which provides complete isolation from your host system.\n\n### Configuration Tools\n\nYou can manage server configuration using the provided tools:\n\n```javascript\n\u002F\u002F Get the entire config\nget_config({})\n\n\u002F\u002F Set a specific config value\nset_config_value({ \"key\": \"defaultShell\", \"value\": \"\u002Fbin\u002Fzsh\" })\n\n\u002F\u002F Set multiple config values using separate calls\nset_config_value({ \"key\": \"defaultShell\", \"value\": \"\u002Fbin\u002Fbash\" })\nset_config_value({ \"key\": \"allowedDirectories\", \"value\": [\"\u002FUsers\u002Fusername\u002Fprojects\"] })\n```\n\nThe configuration is saved to `config.json` in the server's working directory and persists between server restarts.\n\n#### Understanding fileWriteLineLimit\n\nThe `fileWriteLineLimit` setting controls how many lines can be written in a single `write_file` operation (default: 50 lines). This limit exists for several important reasons:\n\n**Why the limit exists:**\n- **AIs are wasteful with tokens**: Instead of doing two small edits in a file, AIs may decide to rewrite the whole thing. We're trying to force AIs to do things in smaller changes as it saves time and tokens\n- **Claude UX message limits**: There are limits within one message and hitting \"Continue\" does not really work. What we're trying here is to make AI work in smaller chunks so when you hit that limit, multiple chunks have succeeded and that work is not lost - it just needs to restart from the last chunk\n\n**Setting the limit:**\n```javascript\n\u002F\u002F You can set it to thousands if you want\nset_config_value({ \"key\": \"fileWriteLineLimit\", \"value\": 1000 })\n\n\u002F\u002F Or keep it smaller to force more efficient behavior\nset_config_value({ \"key\": \"fileWriteLineLimit\", \"value\": 25 })\n```\n\n**Maximum value**: You can set it to thousands if you want - there's no technical restriction.\n\n**Best practices**:\n- Keep the default (50) to encourage efficient AI behavior and avoid token waste\n- The system automatically suggests chunking when limits are exceeded\n- Smaller chunks mean less work lost when Claude hits message limits\n\n### Best Practices\n\n1. **Create a dedicated chat for configuration changes**: Make all your config changes in one chat, then start a new chat for your actual work.\n\n2. **Be careful with empty `allowedDirectories`**: Setting this to an empty array (`[]`) grants access to your entire filesystem for file operations.\n\n3. **Use specific paths**: Instead of using broad paths like `\u002F`, specify exact directories you want to access.\n\n4. **Always verify configuration after changes**: Use `get_config({})` to confirm your changes were applied correctly.\n\n## Command Line Options\n\nDesktop Commander supports several command line options for customizing behavior:\n\n### Disable Onboarding\n\nBy default, Desktop Commander shows helpful onboarding prompts to new users (those with fewer than 10 tool calls). You can disable this behavior:\n\n```bash\n# Disable onboarding for this session\nnode dist\u002Findex.js --no-onboarding\n\n# Or if using npm scripts\nnpm run start:no-onboarding\n\n# For npx installations, modify your claude_desktop_config.json:\n{\n  \"mcpServers\": {\n    \"desktop-commander\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@wonderwhy-er\u002Fdesktop-commander@latest\",\n        \"--no-onboarding\"\n      ]\n    }\n  }\n}\n```\n\n**When onboarding is automatically disabled:**\n- When the MCP client name is set to \"desktop-commander\"\n- When using the `--no-onboarding` flag\n- After users have used onboarding prompts or made 10+ tool calls\n\n**Debug information:**\nThe server will log when onboarding is disabled: `\"Onboarding disabled via --no-onboarding flag\"`\n\n## Using Different Shells\n\nYou can specify which shell to use for command execution:\n\n```javascript\n\u002F\u002F Using default shell (bash or system default)\nexecute_command({ \"command\": \"echo $SHELL\" })\n\n\u002F\u002F Using zsh specifically\nexecute_command({ \"command\": \"echo $SHELL\", \"shell\": \"\u002Fbin\u002Fzsh\" })\n\n\u002F\u002F Using bash specifically\nexecute_command({ \"command\": \"echo $SHELL\", \"shell\": \"\u002Fbin\u002Fbash\" })\n```\n\nThis allows you to use shell-specific features or maintain consistent environments across commands.\n\n1. `execute_command` returns after timeout with initial output\n2. Command continues in background\n3. Use `read_output` with PID to get new output\n4. Use `force_terminate` to stop if needed\n\n## Debugging\n\nIf you need to debug the server, you can install it in debug mode:\n\n```bash\n# Using npx\nnpx @wonderwhy-er\u002Fdesktop-commander@latest setup --debug\n\n# Or if installed locally\nnpm run setup:debug\n```\n\nThis will:\n1. Configure Claude to use a separate \"desktop-commander\" server\n2. Enable Node.js inspector protocol with `--inspect-brk=9229` flag\n3. Pause execution at the start until a debugger connects\n4. Enable additional debugging environment variables\n\nTo connect a debugger:\n- In Chrome, visit `chrome:\u002F\u002Finspect` and look for the Node.js instance\n- In VS Code, use the \"Attach to Node Process\" debug configuration\n- Other IDEs\u002Ftools may have similar \"attach\" options for Node.js debugging\n\nImportant debugging notes:\n- The server will pause on startup until a debugger connects (due to the `--inspect-brk` flag)\n- If you don't see activity during debugging, ensure you're connected to the correct Node.js process\n- Multiple Node processes may be running; connect to the one on port 9229\n- The debug server is identified as \"desktop-commander-debug\" in Claude's MCP server list\n\nTroubleshooting:\n- If Claude times out while trying to use the debug server, your debugger might not be properly connected\n- When properly connected, the process will continue execution after hitting the first breakpoint\n- You can add additional breakpoints in your IDE once connected\n\n## Model Context Protocol Integration\n\nThis project extends the MCP Filesystem Server to enable:\n- Local server support in Claude Desktop\n- Full system command execution\n- Process management\n- File operations\n- Code editing with search\u002Freplace blocks\n\nCreated as part of exploring Claude MCPs: https:\u002F\u002Fyoutube.com\u002Flive\u002FTlbjFDbl5Us\n\n## Support Desktop Commander\n\n\u003Cdiv align=\"center\">\n  \u003Ch3>📢 SUPPORT THIS PROJECT\u003C\u002Fh3>\n  \u003Cp>\u003Cstrong>Desktop Commander MCP is free and open source, but needs your support to thrive!\u003C\u002Fstrong>\u003C\u002Fp>\n  \n  \u003Cdiv style=\"background-color: #f8f9fa; padding: 15px; border-radius: 10px; margin: 20px 0; border: 2px solid #007bff;\">\n    \u003Cp>Our philosophy is simple: we don't want you to pay for it if you're not successful. But if Desktop Commander contributes to your success, please consider contributing to ours.\u003C\u002Fp>\n    \u003Cp>\u003Cstrong>Ways to support:\u003C\u002Fstrong>\u003C\u002Fp>\n    \u003Cul style=\"list-style-type: none; padding: 0;\">\n      \u003Cli>🌟 \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fwonderwhy-er\">\u003Cstrong>GitHub Sponsors\u003C\u002Fstrong>\u003C\u002Fa> - Recurring support\u003C\u002Fli>\n      \u003Cli>☕ \u003Ca href=\"https:\u002F\u002Fwww.buymeacoffee.com\u002Fwonderwhyer\">\u003Cstrong>Buy Me A Coffee\u003C\u002Fstrong>\u003C\u002Fa> - One-time contributions\u003C\u002Fli>\n      \u003Cli>💖 \u003Ca href=\"https:\u002F\u002Fwww.patreon.com\u002Fc\u002FEduardsRuzga\">\u003Cstrong>Patreon\u003C\u002Fstrong>\u003C\u002Fa> - Become a patron and support us monthly\u003C\u002Fli>\n      \u003Cli>⭐ \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\">\u003Cstrong>Star on GitHub\u003C\u002Fstrong>\u003C\u002Fa> - Help others discover the project\u003C\u002Fli>\n    \u003C\u002Ful>\n  \u003C\u002Fdiv>\n\u003C\u002Fdiv>\n\n\n### ❤️ Supporters Hall of Fame\n\nGenerous supporters are featured here. Thank you for helping make this project possible!\n\n\u003Cdiv align=\"center\">\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\n      \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fjonrichards\">\n        \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fjonrichards.png\" width=\"100px;\" alt=\"Jon Richards\"\u002F>\n        \u003Cbr \u002F>\n        \u003Csub>\u003Cb>Jon Richards\u003C\u002Fb>\u003C\u002Fsub>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\">\n      \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fstepanic\">\n        \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fstepanic.png\" width=\"100px;\" alt=\"Matija Stepanic\"\u002F>\n        \u003Cbr \u002F>\n        \u003Csub>\u003Cb>Matija Stepanic\u003C\u002Fb>\u003C\u002Fsub>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\n\u003Cdetails>\n  \u003Csummary>\u003Cstrong>Why your support matters\u003C\u002Fstrong>\u003C\u002Fsummary>\n  \u003Cp>Your support allows us to:\u003C\u002Fp>\n  \u003Cul>\n    \u003Cli>Continue active development and maintenance\u003C\u002Fli>\n    \u003Cli>Add new features and integrations\u003C\u002Fli>\n    \u003Cli>Improve compatibility across platforms\u003C\u002Fli>\n    \u003Cli>Provide better documentation and examples\u003C\u002Fli>\n    \u003Cli>Build a stronger community around the project\u003C\u002Fli>\n  \u003C\u002Ful>\n\u003C\u002Fdetails>\n\n## Website\n\nVisit our official website at [https:\u002F\u002Fdesktopcommander.app\u002F](https:\u002F\u002Fdesktopcommander.app\u002F) for the latest information, documentation, and updates.\n\n## Media\n\nLearn more about this project through these resources:\n\n### Article\n[Claude with MCPs replaced Cursor & Windsurf. How did that happen?](https:\u002F\u002Fwonderwhy-er.medium.com\u002Fclaude-with-mcps-replaced-cursor-windsurf-how-did-that-happen-c1d1e2795e96) - A detailed exploration of how Claude with Model Context Protocol capabilities is changing developer workflows.\n\n### Video\n[Claude Desktop Commander Video Tutorial](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ly3bed99Dy8) - Watch how to set up and use the Commander effectively.\n\n### Publication at AnalyticsIndiaMag\n[![analyticsindiamag.png](testemonials%2Fanalyticsindiamag.png)\nThis Developer Ditched Windsurf, Cursor Using Claude with MCPs](https:\u002F\u002Fanalyticsindiamag.com\u002Fai-features\u002Fthis-developer-ditched-windsurf-cursor-using-claude-with-mcps\u002F)\n\n### Community\nJoin our [Discord server](https:\u002F\u002Fdiscord.gg\u002FkQ27sNnZr7) to get help, share feedback, and connect with other users.\n\n## Testimonials\n\n[![It's a life saver! I paid Claude + Cursor currently which I always feel it's kind of duplicated. This solves the problem ultimately. I am so happy. Thanks so much. Plus today Claude has added the web search support. With this MCP + Internet search, it writes the code with the latest updates. It's so good when Cursor doesn't work sometimes or all the fast requests are used.](https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FClaudeComputerCommander\u002Fmain\u002Ftestemonials\u002Fimg.png) https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ly3bed99Dy8&lc=UgyyBt6_ShdDX_rIOad4AaABAg\n](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ly3bed99Dy8&lc=UgyyBt6_ShdDX_rIOad4AaABAg\n)\n\n[![This is the first comment I've ever left on a youtube video, THANK YOU! I've been struggling to update an old Flutter app in Cursor from an old pre null-safety version to a current version and implemented null-safety using Claude 3.7. I got most of the way but had critical BLE errors that I spent days trying to resolve with no luck. I tried Augment Code but it didn't get it either. I implemented your MCP in Claude desktop and was able to compare the old and new codebase fully, accounting for the updates in the code, and fix the issues in a couple of hours. A word of advice to people trying this, be sure to stage changes and commit when appropriate to be able to undo unwanted changes. Amazing!](https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FClaudeComputerCommander\u002Fmain\u002Ftestemonials\u002Fimg_1.png)\nhttps:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ly3bed99Dy8&lc=UgztdHvDMqTb9jiqnf54AaABAg](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ly3bed99Dy8&lc=UgztdHvDMqTb9jiqnf54AaABAg\n)\n\n[![Great! I just used Windsurf, bought license a week ago, for upgrading old fullstack socket project and it works many times good or ok but also many times runs away in cascade and have to revert all changes losing hundereds of cascade tokens. In just a week down to less than 100 tokens and do not want to buy only 300 tokens for 10$. This Claude MCP ,bought claude Pro finally needed but wanted very good reason to also have next to ChatGPT, and now can code as much as I want not worrying about token cost.\nAlso this is much more than code editing it is much more thank you for great video!](https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FClaudeComputerCommander\u002Fmain\u002Ftestemonials\u002Fimg_2.png)\nhttps:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ly3bed99Dy8&lc=UgyQFTmYLJ4VBwIlmql4AaABAg](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ly3bed99Dy8&lc=UgyQFTmYLJ4VBwIlmql4AaABAg)\n\n[![it is a great tool, thank you, I like using it, as it gives claude an ability to do surgical edits, making it more like a human developer.](https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FClaudeComputerCommander\u002Fmain\u002Ftestemonials\u002Fimg_3.png)\nhttps:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ly3bed99Dy8&lc=Ugy4-exy166_Ma7TH-h4AaABAg](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ly3bed99Dy8&lc=Ugy4-exy166_Ma7TH-h4AaABAg)\n\n[![You sir are my hero. You've pretty much summed up and described my experiences of late, much better than I could have. Cursor and Windsurf both had me frustrated to the point where I was almost yelling at my computer screen. Out of whimsy, I thought to myself why not just ask Claude directly, and haven't looked back since.\nClaude first to keep my sanity in check, then if necessary, engage with other IDEs, frameworks, etc. I thought I was the only one, glad to see I'm not lol.\n33\n1](https:\u002F\u002Fraw.githubusercontent.com\u002Fwonderwhy-er\u002FClaudeComputerCommander\u002Fmain\u002Ftestemonials\u002Fimg_4.png)\nhttps:\u002F\u002Fmedium.com\u002F@pharmx\u002Fyou-sir-are-my-hero-62cff5836a3e](https:\u002F\u002Fmedium.com\u002F@pharmx\u002Fyou-sir-are-my-hero-62cff5836a3e)\n\nIf you find this project useful, please consider giving it a ⭐ star on GitHub! This helps others discover the project and encourages further development.\n\nWe welcome contributions from the community! Whether you've found a bug, have a feature request, or want to contribute code, here's how you can help:\n\n- **Found a bug?** Open an issue at [github.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Fissues](https:\u002F\u002Fgithub.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Fissues)\n- **Have a feature idea?** Submit a feature request in the issues section\n- **Want to contribute code?** Fork the repository, create a branch, and submit a pull request\n- **Questions or discussions?** Start a discussion in the GitHub Discussions tab\n\nAll contributions, big or small, are greatly appreciated!\n\nIf you find this tool valuable for your workflow, please consider [supporting the project](https:\u002F\u002Fwww.buymeacoffee.com\u002Fwonderwhyer).\n\n## Frequently Asked Questions\n\nHere are answers to some common questions. For a more comprehensive FAQ, see our [detailed FAQ document](FAQ.md).\n\n### What is Desktop Commander?\nIt's an MCP tool that enables Claude Desktop to access your file system and terminal, turning Claude into a versatile assistant for coding, automation, codebase exploration, and more.\n\n### How is this different from Cursor\u002FWindsurf?\nUnlike IDE-focused tools, Claude Desktop Commander provides a solution-centric approach that works with your entire OS, not just within a coding environment. Claude reads files in full rather than chunking them, can work across multiple projects simultaneously, and executes changes in one go rather than requiring constant review.\n\n### Do I need to pay for API credits?\nNo. This tool works with Claude Desktop's standard Pro subscription ($20\u002Fmonth), not with API calls, so you won't incur additional costs beyond the subscription fee.\n\n### Does Desktop Commander automatically update?\nYes, when installed through npx or Smithery, Desktop Commander automatically updates to the latest version when you restart Claude. No manual update process is needed.\n\n### What are the most common use cases?\n- Exploring and understanding complex codebases\n- Generating diagrams and documentation\n- Automating tasks across your system\n- Working with multiple projects simultaneously\n- Making surgical code changes with precise control\n\n### I'm having trouble installing or using the tool. Where can I get help?\nJoin our [Discord server](https:\u002F\u002Fdiscord.gg\u002FkQ27sNnZr7) for community support, check the [GitHub issues](https:\u002F\u002Fgithub.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Fissues) for known problems, or review the [full FAQ](FAQ.md) for troubleshooting tips. You can also visit our [website FAQ section](https:\u002F\u002Fdesktopcommander.app#faq) for a more user-friendly experience. If you encounter a new issue, please consider [opening a GitHub issue](https:\u002F\u002Fgithub.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Fissues\u002Fnew) with details about your problem.\n\n### How do I report security vulnerabilities?\nPlease create a [GitHub Issue](https:\u002F\u002Fgithub.com\u002Fwonderwhy-er\u002FDesktopCommanderMCP\u002Fissues) with detailed information about any security vulnerabilities you discover. See our [Security Policy](SECURITY.md) for complete guidelines on responsible disclosure.\n\n## Data Collection & Privacy\n\nDesktop Commander collects limited, pseudonymous telemetry to improve the tool. We do not collect file contents, file paths, or command arguments.\n\n**Opt-out:** Ask Claude to \"disable Desktop Commander telemetry\" or set `\"telemetryEnabled\": false` in your config.\n\nFor complete details, see our [Privacy Policy](PRIVACY.md).\n\n## Verifications\n[![Verified on MseeP](https:\u002F\u002Fmseep.ai\u002Fbadge.svg)](https:\u002F\u002Fmseep.ai\u002Fapp\u002F25ff7a06-58bc-40b8-bd79-ebb715140f1a)\n\n## License\n\nMIT\n","Desktop Commander MCP 是一个为 Claude AI 提供终端控制、文件系统搜索和差异文件编辑功能的服务器。它允许用户通过AI执行终端命令、管理和更新文件，利用Model Context Protocol (MCP)协议实现更高效的代码分析与生成。项目采用TypeScript编写，具备强大的文件预览界面及Markdown编辑器支持，并能处理长时间运行的任务。适合开发者在需要自动化脚本执行、文件操作或是希望通过对话式界面进行代码管理等场景下使用，尤其对于希望集成多种开发工具于单一聊天界面中的团队和个人而言，是一个理想选择。",2,"2026-06-11 03:46:05","high_star"]