Run terminal commands and interact with long-running processes or REPL sessions.
Good to know
Commands use local user permissions; retained output is bounded and older lines can be discarded.
Unclaimed
Are you @wonderwhy-er?Claim it, and your coding agent keeps it current with each release
Written by 
Are you @wonderwhy-er?Claim it, and your coding agent keeps it current with each release
Read, search and edit local files, work with documents, and run interactive terminal commands from an MCP-compatible AI client.
What you can do with Desktop Commander MCP
List running processes and stop them by process ID.
Good to know
Requires the operating-system permissions needed to inspect or terminate a process.
Read, write, move and inspect files, and list directories recursively.
1 other tool for: Read local filesGood to know
Default limits are 1,000 lines per read and 50 per write; directory listings default to depth 2.
Replace selected text in files without rewriting the whole file.
Good to know
Uses text matching; fuzzy matches provide feedback when exact text is not found.
Search filenames and file contents with streamed, paginated results.
Good to know
Uses ripgrep; results are retrieved from an active search session.
Read text or supported images from a URL through the file-reading tool.
Good to know
Requires URL mode and network access from the server.
Set allowed folders, blocked commands, the default shell, file limits and telemetry preferences.
Good to know
These are guardrails, not a sandbox. An empty folder allowlist permits all filesystem paths; command restrictions have documented bypasses.
Review recent tool calls and their arguments and results to recover context.
Good to know
Keeps up to 1,000 recent calls; large outputs are omitted and the history file is size-trimmed. Local arguments may contain sensitive values.
Show all 22
Run file and terminal tasks inside a Docker container with selected host folders mounted.
Good to know
Requires Docker running; host access depends on mounted folders and container configuration.
Connect an MCP-compatible AI client to local file and terminal tools.
Good to know
npm installation requires Node.js 18 or newer; client configuration and a running local server are required.
Open getting-started examples for local file and terminal workflows.
Good to know
Automatic guidance is shown to new users; the README documents `--no-onboarding` to disable it.
Read PDF text and images, create PDFs from markdown, and insert or delete pages.
Good to know
Changing existing page content can lose styling; modifications use a separate output file. PDF creation uses a browser.
Read, create, edit and search Excel spreadsheets by sheet or cell range.
Good to know
Supports .xlsx, .xls and .xlsm; reads return JSON arrays, with pagination for large sheets.
Run local commands and edit files from ChatGPT, Claude web or another remote MCP client.
Good to know
Requires a running local Remote Device, browser authentication and the hosted Remote MCP service; commands use local user permissions.
Preview rendered markdown and images inside Claude Desktop and expand partial file reads.
Good to know
Requires file-preview UI support; the release documents macOS and Windows.
Read, create, edit and search Word documents through the file tools.
Good to know
Reads default to an outline; `offset=1` returns XML for precise editing. Creation converts markdown headings; direct edits operate on XML.
Change allowed folders, blocked commands, file limits and telemetry in a settings panel.
Good to know
Requires a host that renders the settings UI.
Edit markdown in the preview pane and copy formatted content into rich-text applications.
Good to know
Requires preview UI support; v0.2.39 could corrupt markdown during autosave, fixed in v0.2.40.
Use Desktop Commander's local file and terminal tools as a Gemini CLI extension.
Good to know
Requires Gemini CLI and the extension installation.
Use Desktop Commander's file, document and terminal tools through its Claude Code plugin.
Good to know
Requires Claude Code and plugin installation; the release describes plugin packaging, not confirmed marketplace acceptance.
Connect Cursor to Desktop Commander through the repository's prefilled install link.
Good to know
Requires Cursor and confirmation of the supplied MCP server configuration.
Remove saved Remote MCP credentials from the local computer.
Good to know
`remote --logout` removes local credentials only; server-side device authorization must be revoked separately.
Before you upgrade Desktop Commander MCP
Newest firstDenied or expired authorization codes stop polling and report failure instead of continuing to wait for authorization.
Read the evidence
Browser authorization no longer asks users to type a code already carried by the link.
Read the evidence
Remote authentication now persists by default. Use `--no-persist-session` for authorization on each run; `--persist-session` remains accepted as a no-op.
Show 24 older
Large stored results are replaced with an omission marker by the new 4 KiB output cap; history is a recent-action record rather than a full result archive.
Fuzzy-search telemetry no longer sends `character_codes`.
Read the evidence
Complete fresh browser authorization when restarting a revoked or removed device; the saved session no longer silently recreates that device.
Pass `mode: "append"` or `mode: "rewrite"` to `write_file` for existing non-empty files. Omitting the mode is still allowed for new or empty files.
Read the evidence
Per-session output is capped at 50 × 1024 × 1024 characters; oldest lines are discarded and pagination then refers to the retained buffer.
Unrecognized tool parameters now trigger a warning listing supported parameters instead of being silently dropped.
Read the evidence
`write_pdf` prunes stale downloaded Chrome builds in Desktop Commander's own cache; older shared Puppeteer caches are untouched.
Read the evidence
To reclaim old browser downloads, remove `~/.cache/puppeteer` or `%USERPROFILE%\.cache\puppeteer` only if no other application needs it; automatic cleanup does not touch this shared cache.
Read the evidence
`list_directory` reports `[NOT_FOUND]` for nonexistent paths instead of `[DENIED]`; permission and timeout errors remain `[DENIED]`.
Read the evidence
Upgrade v0.2.39 to v0.2.40 before using markdown autosave; v0.2.39 could rewrite tables, wikilinks, YAML frontmatter and escapes.
Read the evidence
The local history file is capped at 5 MiB and trimmed to roughly the newest 4 MiB, preventing unbounded growth and related crashes.
Read the evidence
Excel and DOCX searches fall back to literal matching for regexes detected as prone to catastrophic backtracking.
Read the evidence
Use only `blockedCommands`, `allowedDirectories`, `defaultShell`, `telemetryEnabled`, `fileReadLineLimit` or `fileWriteLineLimit` with `set_config_value`; other keys are rejected.
Commands are denied when command-blocklist validation fails instead of being allowed through.
Read the evidence
`set_config_value` no longer accepts `onboarding_injection`; use the documented `--no-onboarding` startup option to suppress onboarding.
Use an explicit absolute path for another user's home directory; tilde expansion is restricted to the current user.
Read the evidence
macOS defaults to zsh when `SHELL` is unset, loading shell profiles used by tools such as Homebrew and `nvm`.
Read the evidence
`edit_block` now rejects an empty `new_string` in text-replacement mode. Workflows deleting text need another editing method for this release.
Read the evidence
`read_process_output` adds `offset` and `length`; returned lines respect `fileReadLineLimit`. Zero reads new output, positive offsets are absolute, and negative offsets read from the tail.
Read the evidence
Anonymous use-case collection is disabled; this does not disable all telemetry.
Read the evidence
Windows users with failed npx connections should rerun `npx @wonderwhy-er/[email protected] setup`; generated configuration uses `cmd /c npx`.
Read the evidence
Replace `get_prompts` actions `list_categories` and `list_prompts` with `get_prompt` and a required `promptId`; those listing actions are no longer accepted.
Read the evidence
On macOS/Linux, default-shell selection uses `SHELL` when available; bash and zsh commands run as login shells so profile environment settings load.
Read the evidence
Logging notifications are disabled for Cline to avoid duplicate chat messages and toasts.
Read the evidence
Desktop Commander MCP release history 17
Recover pending remote calls after the device reconnects.
Details
Readiness now depends on both a usable local executor and a reachable channel; authorization stops promptly on denied or expired codes.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Now works: Run local commands and edit files from ChatGPT, Cla…Behavior changed: Run local commands and edit files from ChatGPT, Cla…
Seeded by @iluxav with Codex
Read the evidence
Restart a long-running remote device without reusing an expired refresh token.
Details
Refreshed remote credentials are saved as they rotate; local process death fails pending calls promptly.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Now works: Run local commands and edit files from ChatGPT, Cla…Behavior changed: Run local commands and edit files from ChatGPT, Cla…
Seeded by @iluxav with Codex
Read the evidence
v0.2.50
with v0.2.48
with v0.2.48
Reconnect a remote device without losing access after a local process failure.
Details
v0.2.48 makes remote session persistence the default; v0.2.50 adds local logout and recovery after process failures or revoked devices.
Also: Read PowerShell UTF-16LE files and preserve configuration across multiple server processes.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Behavior changed: Run local commands and edit files from ChatGPT, Cla…Now works: List running processes and stop them by process ID.Behavior changed / inferred: Review recent tool calls and their arguments and re…Now works: Run local commands and edit files from ChatGPT, Cla…Added / inferred: Remove saved Remote MCP credentials from the local…Now works: Set allowed folders, blocked commands, the default…Now works: Read, write, move and inspect files, and list direc…Behavior changed: Set allowed folders, blocked commands, the default…Action required: Run local commands and edit files from ChatGPT, Cla…
Seeded by @iluxav with Codex
Read the evidence
- wonderwhy-er/DesktopCommanderMCP/releases/tag/v0.2.48
- wonderwhy-er/DesktopCommanderMCP/blob/v0.2.48/src/npm-scripts/remote.ts
- wonderwhy-er/DesktopCommanderMCP/blob/v0.2.48/src/utils/toolHistory.ts
- wonderwhy-er/DesktopCommanderMCP/releases/tag/v0.2.50
- wonderwhy-er/DesktopCommanderMCP/blob/v0.2.50/src/npm-scripts/remote.ts
- wonderwhy-er/DesktopCommanderMCP/blob/v0.2.50/src/remote-device/device.ts
- wonderwhy-er/DesktopCommanderMCP/blob/v0.2.50/src/utils/files/text.ts
Avoid overwriting a populated file when a write call omits its mode.
Details
Existing non-empty files require an explicit write mode; stalled reads and previews now time out instead of hanging indefinitely.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Action required: Read, write, move and inspect files, and list direc…Now works: Read, write, move and inspect files, and list direc…Now works: Run local commands and edit files from ChatGPT, Cla…Now works: Preview rendered markdown and images inside Claude…
Seeded by @iluxav with Codex
Read the evidence
Keep editing large files without freezing other tool calls.
Details
Large-file fuzzy matching no longer blocks the server; terminal output retention is bounded and unknown tool parameters produce warnings.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Now works: Replace selected text in files without rewriting th…Behavior changed / inferred: Run terminal commands and interact with long-runnin…Behavior changed: Connect an MCP-compatible AI client to local file a…Now works: Preview rendered markdown and images inside Claude…Now works: Run local commands and edit files from ChatGPT, Cla…
Seeded by @iluxav with Codex
Read image files so the model receives the image content on affected clients.
Details
Image responses and structured directory listings are corrected; Windows terminal quoting and PATH handling are fixed.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Now works: Read, write, move and inspect files, and list direc…Now works: Run terminal commands and interact with long-runnin…Behavior changed: Read PDF text and images, create PDFs from markdown…Action required: Read PDF text and images, create PDFs from markdown…
Seeded by @iluxav with Codex
Read the evidence
Read spreadsheet ranges that include sheet names, including quoted names.
Details
Excel reads accept `Sheet!Cells`; file previews survive refresh and new-file writes respect resolved symlink targets.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Now works: Read, create, edit and search Excel spreadsheets by…Now works: Set allowed folders, blocked commands, the default…Now works: Preview rendered markdown and images inside Claude…Now works: Connect an MCP-compatible AI client to local file a…Behavior changed: Read, write, move and inspect files, and list direc…Added: Use Desktop Commander's file, document and terminal…Added: Connect Cursor to Desktop Commander through the rep…
Seeded by @iluxav with Codex
Read the evidence
v0.2.40
with v0.2.39
with v0.2.39
Edit markdown visually without the autosave corruption reported in v0.2.39.
Details
The new markdown editor and directory browser from v0.2.39 are paired with v0.2.40's autosave safeguards.
Also: Browse directories visually and use the Gemini CLI extension.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Added: Edit markdown in the preview pane and copy formatte…Action required: Edit markdown in the preview pane and copy formatte…Improved: Preview rendered markdown and images inside Claude…Added: Use Desktop Commander's local file and terminal too…Behavior changed: Review recent tool calls and their arguments and re…Now works: Set allowed folders, blocked commands, the default…Behavior changed: Search filenames and file contents with streamed, p…
Seeded by @iluxav with Codex
Edit Desktop Commander settings in a visual panel.
Details
A settings UI exposes user configuration; `set_config_value` rejects unknown keys and invalid boolean values.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Added: Change allowed folders, blocked commands, file limi…Action required: Set allowed folders, blocked commands, the default…Behavior changed: Run terminal commands and interact with long-runnin…Action required / inferred: Open getting-started examples for local file and te…
Seeded by @iluxav with Codex
v0.2.37
with v0.2.36
with v0.2.36
Read, create, edit and search Word documents through the existing file tools.
Details
DOCX support joins the file preview UI from v0.2.36; text deletion through `edit_block` works again.
Also: Preview files visually and suppress onboarding through the local config.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Added: Preview rendered markdown and images inside Claude…Added: Read, create, edit and search Word documents throug…Action required / inferred: Read, write, move and inspect files, and list direc…Now works / inferred: Replace selected text in files without rewriting th…Now works: Open getting-started examples for local file and te…Now works: Run file and terminal tasks inside a Docker contain…
Seeded by @iluxav with Codex
Apply folder restrictions to symlink targets when reading or writing existing files.
Details
Path validation resolves symlinks, and command blocking handles absolute paths and command substitution.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Now works: Set allowed folders, blocked commands, the default…Now works: Connect an MCP-compatible AI client to local file a…
Seeded by @iluxav with Codex
Read the evidence
Use ChatGPT or Claude web to work with files and commands on your computer.
Details
Remote MCP runs a local device connected to the hosted service; PDF creation now finds or downloads a browser.
v0.2.30 with Node.js 18+; remote mode starts with `npx @wonderwhy-er/[email protected] remote` and requires browser authorization.
Added: Run local commands and edit files from ChatGPT, Cla…Now works: Read PDF text and images, create PDFs from markdown…Behavior changed: Run terminal commands and interact with long-runnin…Action required / inferred: Replace selected text in files without rewriting th…
Seeded by @iluxav with Codex
Read, create and rearrange PDF documents from your AI client.
Details
`write_pdf` adds PDF creation and page operations; existing file tools gain spreadsheet support and process output gains line pagination.
Also: Work with Excel sheets and paginate terminal output.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Added: Read PDF text and images, create PDFs from markdown…Added: Read, create, edit and search Excel spreadsheets by…Behavior changed: Run terminal commands and interact with long-runnin…Now works: Connect an MCP-compatible AI client to local file a…Behavior changed: Set allowed folders, blocked commands, the default…
Seeded by @iluxav with Codex
Read the evidence
Start Desktop Commander through npx on Windows without the previous connection failure.
Details
Windows setup now launches through `cmd /c npx`; onboarding is simplified and its tool accepts only named prompts.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Action required: Connect an MCP-compatible AI client to local file a…Action required / inferred: Open getting-started examples for local file and te…
Seeded by @iluxav with Codex
Run shell commands with your login-shell environment.
Details
Shell selection now uses the user's shell when available; extension search and Cline notifications are corrected.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Behavior changed: Run terminal commands and interact with long-runnin…Now works: Search filenames and file contents with streamed, p…Behavior changed: Connect an MCP-compatible AI client to local file a…
Seeded by @iluxav with Codex
Read the evidence
Interact with terminal sessions without an unnecessary eight-second wait.
Details
`interact_with_process` returns when output is ready, and terminal sessions continue working after their first interaction.
Install @wonderwhy-er/[email protected] with Node.js 18+ and an MCP-compatible client.
Now works: Run terminal commands and interact with long-runnin…Now works: Search filenames and file contents with streamed, p…Now works: Connect an MCP-compatible AI client to local file a…
Seeded by @iluxav with Codex
Read the evidence
v0.2.17
Starting point
Starting point
Use an AI client to work with local files and terminal sessions.
Details
This baseline records capabilities already present before the one-year release window: file operations, text editing, search, terminal sessions, configuration and local history.
v0.2.17; install @wonderwhy-er/desktop-commander through npm with Node.js 18+, or use the documented Docker installation.
Added: Run terminal commands and interact with long-runnin…Added: List running processes and stop them by process ID.Added: Read, write, move and inspect files, and list direc…Added: Replace selected text in files without rewriting th…Added: Search filenames and file contents with streamed, p…Added: Read text or supported images from a URL through th…Added: Set allowed folders, blocked commands, the default…Added: Review recent tool calls and their arguments and re…Added: Run file and terminal tasks inside a Docker contain…Added: Connect an MCP-compatible AI client to local file a…Added: Open getting-started examples for local file and te…
Seeded by @iluxav with Codex