CLI (Desktop Commander)

🚀 Desktop Commander Guide

Desktop Commander is an MCP tool designed to empower Claude Desktop with access to the file system and terminal, transforming it into an all - around assistant for tasks such as coding, automation, and codebase exploration.

🚀 Quick Start

Basic Commands

• File Browsing

  cdc ls /path/to/directory
  

• Code Generation

  cdc generate "Create a new component"
  

• Automation Script

  cdc automate run ./script.js
  

✨ Features

• Operating System Integration: Interact directly with your computer's file system.
• Multi - project Support: Handle multiple projects simultaneously.
• One - time Execution: Complete changes in one go without multiple reviews.
• Automated Tasks: Easily implement system - level automation operations.

📦 Installation

Installation Steps

1. Get the Tool
   • Install using the Node.js package manager:

     npm install -g claude-desktop-commander
     

   • Install via Smithery:

     smithery install desktop-commander
     

2. Start the Commander
   • Start it by entering the following command in the terminal:

     cdc start
     

3. Configuration Options (Optional)
   • Use the --config option to specify the configuration file path:

     cdc start --config ./config.json
     

📚 Documentation

Beginner Tutorial

1. Installation and Configuration: Follow the Installation Guide to complete the installation and basic setup of the tool.
2. Core Commands: Familiarize yourself with and master the operation methods of the Basic Commands.

Intermediate Tutorial

1. In - depth Integration: Explore how to seamlessly integrate Desktop Commander with your existing workflow.
2. Script Writing: Learn how to write custom scripts to extend the tool's functionality.

Advanced Tutorial

1. Plugin Development: Create custom plugins for the tool to enhance its capabilities.
2. Batch Processing: Master how to handle complex tasks for multiple projects at once.

🤝 Project Contribution

If you find this project helpful, please consider giving it a ⭐ star on GitHub. This will help more people discover the project and encourage further development.

We welcome contributions from the community! Whether you've found a bug, have a feature suggestion, or want to submit code, here's how you can help:

• Found a bug? Open an issue at github.com/wonderwhy-er/ClaudeComputerCommander/issues.
• Have an idea for a feature? Submit it to the Feature Request section.
• Want to submit code? Fork the repository, create a branch, and submit a pull request.
• Have questions or discussions? Start a new topic in the GitHub discussion area.

All contributions, big or small, are greatly welcome!

If you find this tool valuable for your workflow, please consider Supporting the Project.

❓ Frequently Asked Questions

Here are brief answers to some common questions. For more comprehensive information, please refer to our Detailed FAQ Document.

What is Desktop Commander?

It is an MCP tool that enables Claude Desktop to access the file system and terminal, turning Claude into an all - around assistant for tasks such as coding, automation, and codebase exploration.

How is it different from Cursor/Windsurf?

Unlike tools that focus on specific areas (e.g., Cursor for editing or Windsurf for browsing), Desktop Commander provides a unified interface to manage and control the entire development process. It integrates multiple functions, reduces the number of different tools needed, and offers a more efficient workflow.

How do I start using it?

After completing the installation following the Installation Guide, you can start using it with simple commands. For example:

npm install -g claude-desktop-commander
cdc start

📁 Project Structure

• Source Code: Located in the src/ directory, including the implementation of the core tool.
• Configuration Files: By default in config/, users can customize the settings.
• Documentation: Detailed usage and development guides are provided in docs/.

📋 Release Notes

Version 1.0.0 (2023 - 10 - 01)

• Initial version released
• Basic functions implemented
• Documentation initially completed

📄 License

The project follows the MIT license. Please refer to the LICENSE file for specific details.

👏 Contributors

Thank you to all those who have contributed to this project! Your support has made it better.