Deskcommand

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 7, 2026

Run terminal processes, edit files and search code on the local machine from an MCP client.

VerifiedSTDIODesktop onlyFiles & StorageDeveloper Tools

Overview

AI-generated overview

Lets an assistant run shell processes, read and write files, edit text and search code on the local machine through a stdio MCP server.

What you can do
  • Read, write and inspect files: read one or many files, write or overwrite files, create directories, move or rename, get metadata, list directories
  • Edit text surgically by replacing an exact block, refusing ambiguous matches
  • Search file contents under a path as a paged session, with start, fetch more, list and stop
  • Run terminal processes: start in a shell, send input, read new output, list sessions and processes, kill by PID or force-terminate
  • Inspect the server itself: configuration get/set, usage stats, recent tool calls, prompts, and a feedback tool
When to use it
Useful when an assistant needs to work directly on a local codebase or machine: reading and editing project files, searching source, and running or driving shell commands and long-running processes from the chat client.
Requirements
Runs locally over stdio, either via npx with the npm package or via the published Docker image. No authentication, environment variables or headers are declared. Desktop only; no web-hosted option.
Before you install
It gives the assistant broad local power: writing and overwriting files, moving them, and starting or killing shell processes, so scope it to a trusted workspace. The write_pdf tool writes content as given rather than producing real PDF layout, and search runs synchronously in-process rather than via ripgrep.

Installation

In SourceWeft

  1. Open Deskcommand in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

deskcommand

Work on the local machine from the command line or as a stdio MCP server: start and drive terminal processes, read and write files, make surgical text edits, move files, inspect metadata, and search file contents — with configuration, usage and recent-call tools alongside.

Filesystem and search are real local implementations. Search runs as a session: start_search walks the tree (skipping node_modules, .git and dist) and returns a session id whose results paginate with get_more_search_results. edit_block replaces an exact text block and refuses ambiguous edits — a block that occurs more than once needs an explicit expected count. Terminal processes run behind an injectable executor; the default spawns real shell processes and buffers their output, so read_process_output returns only output you have not seen yet.

Two honest simplifications against the toolset this is modelled on: write_pdf writes the given content as-is (no PDF layout engine), and search executes synchronously in-process rather than streaming from a ripgrep subprocess.

Install

bash
npx -y @reneturcios/deskcommand mcp

CLI

bash
deskcommand mcpdeskcommand ls <path>deskcommand read <path>deskcommand run <command...>deskcommand search <path> <pattern>deskcommand --version

Exit codes: 0 success, 1 operation error, 2 usage error.

MCP tools

26 tools: create_directory, edit_block, force_terminate, get_config, get_file_info, get_more_search_results, get_prompts, get_recent_tool_calls, get_usage_stats, give_feedback_to_desktop_commander, interact_with_process, kill_process, list_directory, list_processes, list_searches, list_sessions, move_file, read_file, read_multiple_files, read_process_output, set_config_value, start_process, start_search, stop_search, write_file, write_pdf.

MCP client config:

json
{  "mcpServers": {    "deskcommand": {      "command": "npx",      "args": ["-y", "@reneturcios/deskcommand", "mcp"]    }  }}

Docker

bash
docker run -i ghcr.io/cloudcorprecords/deskcommand          # MCP serverdocker run --rm ghcr.io/cloudcorprecords/deskcommand --version

Development

bash
npm installnpm run buildnpm test

MIT license.

Source: README.md at commit 7e7abb9

Tools

26

create_directory

Create a new directory or ensure a directory exists, including nested paths

Parameterspathrequired

edit_block

Apply a surgical text replacement in a file: replace old_string with new_string

Parametersfile_pathrequirednew_stringrequiredold_stringrequiredexpected_replacements

force_terminate

Force terminate a running terminal process session

Parameterspidrequired

get_config

Get the current server configuration

Takes no parameters.

get_file_info

Retrieve detailed metadata about a file or directory

Parameterspathrequired

get_more_search_results

Get more results from an active search session

ParameterslengthoffsetsessionIdrequired

get_prompts

Get available prompts, or one prompt by id

ParameterspromptId

get_recent_tool_calls

Get the recent tool calls recorded by this server

Takes no parameters.

get_usage_stats

Get usage statistics for this server

Takes no parameters.

give_feedback_to_desktop_commander

Record feedback about this tool for later review

Parametersmessagerequired

interact_with_process

Send input to a running process and wait for its response

Parameterspidrequiredinputrequiredtimeout_ms

kill_process

Terminate a process by its PID

Parameterspidrequired

list_directory

Get a detailed listing of all files and directories at a path

Parameterspathrequired

list_processes

List all running processes with their PID, command and status

Takes no parameters.

list_searches

List all active search sessions

Takes no parameters.

list_sessions

List all active terminal sessions

Takes no parameters.

move_file

Move or rename a file or directory

Parameterssourcerequireddestinationrequired

read_file

Read the complete contents of a file, optionally a line range

Parameterspathrequiredlengthoffset

read_multiple_files

Read the contents of multiple files simultaneously

Parameterspathsrequired

read_process_output

Read output from a running process, waiting up to a timeout for new output

Parameterspidrequiredtimeout_ms

set_config_value

Set a configuration value by key

Parameterskeyrequiredvaluerequired

start_process

Start a new terminal process in a shell and return its initial output

Parametersshellcommandrequiredtimeout_ms

write_file

Create a new file or completely overwrite an existing file with new content

Parameterspathrequiredcontentrequired

write_pdf

Write text content to a file at a path (PDF-oriented in the original; this rebuild writes the content as given)

Parameterspathrequiredcontentrequired

Version history

1
  1. v0.1.0LatestOct 31, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts