Desktop Commander

Desktop Commander

运行和管理长时间进程 - 安装、抓取、视频编码、编译 搜索、阅读和编辑文件 - 包括差异编辑以提高速度和精度

npm 下载量

核心功能

  • 终端命令执行:运行和管理长时间进程(安装、抓取、编译等)
  • 基于差异的文件编辑:精准搜索和替换,大幅提升代码编辑的速度和准确性

安装

前提:安装 Claude 桌面应用npm

最简单安装方式

npx @wonderwhy-er/desktop-commander setup

安装后请重启 Claude

使用方法

终端命令

执行命令并获取输出:

execute_command --command="ls -la" --timeout=5000

处理长时间运行的命令:

# 执行命令,获取初始输出和PID
execute_command --command="npm install" --timeout=10000
# 使用PID查看后续输出
read_output --session_id=12345
# 必要时终止命令
force_terminate --session_id=12345

文件编辑

小改动:使用差异块进行精准替换(推荐用于小于20%文件内容的更改)

edit_block --blocks="
main.js
<<<<<<< SEARCH
console.log("旧消息");
=======
console.log("新消息");
>>>>>>> REPLACE
"

大改动:完全重写文件内容

write_file --path="main.js" --content="// 这是完全新的文件内容\nconsole.log('全新的代码');"

文件操作

# 读取文件
read_file --path="package.json"

# 搜索文件
search_files --pattern="*.js" --directory="src" --recursive=true

# 列出目录内容
list_directory --path="src" --recursive=false

高级功能

  • 进程管理:list_processes, kill_process
  • 目录操作:create_directory, move_file
  • 文件元数据:get_file_info
  • 命令管理:list_sessions, block_command, unblock_command

详细文档:GitHub 仓库

许可证

MIT