desktop-commander-overview

Interact with local operating systems and remote SSH machines via persistent shell sessions.

19|3|Updated May 17, 2026
One-click install
npx skills add https://github.com/cline/skills --skill desktop-commander-overview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: desktop-commander-overview
Source: https://github.com/cline/skills/tree/main/skills/desktop-commander-overview
Command: npx skills add https://github.com/cline/skills --skill desktop-commander-overview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standard AI agents are confined to the IDE workspace and cannot interact with persistent shell sessions, files outside the project directory, structured documents like Excel or PDFs, or remote machines over SSH, leaving critical real-world system and operational tasks out of reach.

Core Features & Use Cases

  • Persistent Shells & Long-Running Processes: Keep dev servers, REPLs, and data analysis sessions alive across multiple agent turns, eliminating the need to re-setup environments between commands. For example, a developer can start a local API server, edit route files, and test endpoints in the same session without restarting the server.
  • Full Filesystem & Structured File Support: Access and edit files anywhere on the user's system, natively modify Excel, DOCX, and PDF files without regenerating approximations, and search large local datasets like CSVs with ripgrep at scale.
  • Remote SSH Access: Connect to remote machines once and run diagnostics, deployments, or log tailing across multiple turns without re-authenticating each step.

Quick Start

Ask the agent to start a persistent Python REPL, load a large local CSV file into pandas, and run a groupby analysis to summarize Q3 sales data by region.

Frequently Asked Questions about desktop-commander-overview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep a local dev server running across multiple AI agent turns?

Persistent shell sessions allow an AI agent to keep local dev servers, REPLs, and long-running processes alive across multiple turns. This eliminates the need to re-setup environments or restart servers between commands.

Can I use an AI agent to edit structured files like Excel and PDFs natively?

Yes, agents can natively modify structured document formats like Excel, DOCX, and PDF files without regenerating approximations. This allows direct access and editing of files anywhere on your local system.

What is the best way to run diagnostics on a remote server using an AI agent?

Remote SSH access enables agents to connect to remote machines once and run diagnostics, deployments, or log tailing across multiple turns without re-authenticating each step, streamlining operational workflows.

How do I search large local CSV datasets with an AI agent?

You can search large local datasets like CSVs at scale using ripgrep integration. This provides full filesystem access to find and analyze data across directories outside the standard IDE workspace.

Do I need a specific MCP server to access my local filesystem from an AI agent?

Yes, you need integration with the Desktop Commander MCP server with configured allowed directory scopes. This setup provides the necessary filesystem, process, SSH, and document processing tools.

Why does my AI agent only operate inside the IDE workspace?

Standard AI agents are confined to the IDE workspace and cannot interact with persistent shell sessions, files outside the project directory, structured documents, or remote machines, limiting real-world system tasks.