Skip to content
Back to search

rockdesk

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rockdesk-io--rockdesk-skill/badge.svg)](/listings/rockdesk-io--rockdesk-skill)

HTML

<a href="/listings/rockdesk-io--rockdesk-skill"><img src="/api/listings/rockdesk-io--rockdesk-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

| Agent / Client | Recommended Install | |---|---| | **Claude Code** | `claude mcp add -s user rockdesk -- rds mcp` or `/plugin install rockdesk --marketplace rockdesk-io/rockdesk-skill` | | **OpenAI Codex CLI** | `codex mcp add rockdesk -- rds mcp` or `codex plugin marketplace add rockdesk-io/rockdesk-skill` | | **Gemini CLI** | `gemini extensions install https://github.com/rockdesk-io/rockdesk-skill` | | **DeepSeek Harness (`dsh`)** | `dsh plugin --profile <profile> add github:rockdesk-io/rockdesk-skill` | | **TRAE / Cursor / Windsurf / Qwen** | `npx skills add rockdesk-io/rockdesk-skill` or stdio MCP `{"command": "rds", "args": ["mcp"]}` | | **WorkBuddy** | Search **RockDesk** in WorkBuddy Open Platform or install via `npx skills add rockdesk-io/rockdesk-skill` |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines
  1. {
  2. "name": "rockdesk",
  3. "owner": {
  4. "name": "RockDesk",
  5. "email": "dev@rockdesk.io"
  6. },
  7. "metadata": {
  8. "description": "RockDesk skill: let Claude Code operate your other computers by machine ID. Needs the RockDesk app on both machines: https://rockdesk.io/#download (in China: https://rockdesk.cn/#download)."
  9. },
  10. "plugins": [
  11. {
  12. "name": "rockdesk",
  13. "displayName": "RockDesk",
  14. "source": "./plugins/rockdesk",
  15. "description": "Let your agent work on your other computers through RockDesk's rds command line: shell, files, screenshots, mouse and keyboard, clipboard, port / serial / USB forwarding. Needs the RockDesk app on both machines: https://rockdesk.io/#download (in China: https://rockdesk.cn/#download).",
  16. "version": "1.0.17",
  17. "author": {
  18. "name": "RockDesk",
  19. "email": "dev@rockdesk.io"
  20. },
  21. "homepage": "https://rockdesk.io",
  22. "category": "productivity"
  23. }
  24. ]
  25. }
README.md · README · 151 lines · 1 finding marked
  1. # RockDesk skill and MCP server for Claude Code, Codex, Gemini CLI, DeepSeek Harness and other agents
  2. [![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/rockdesk-io/rockdesk-skill) [![Official MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.rockdesk%2Frockdesk-2563eb)](https://rockdesk.io/ai-agents.html) [![Open VSX](https://img.shields.io/badge/Open%20VSX-rockdesk.rockdesk-0f766e)](https://open-vsx.org/extension/rockdesk/rockdesk) [![Homebrew Cask](https://img.shields.io/badge/Homebrew-rockdesk--io%2Ftap-d97706)](https://github.com/rockdesk-io/homebrew-tap)
  3. ```
  4. npx skills add rockdesk-io/rockdesk-skill
  5. ```
  6. **Needs the RockDesk app on both machines** — the skill only teaches your agent the commands; RockDesk does the work. [Download RockDesk](https://rockdesk.io/#download) (in China: [rockdesk.cn](https://rockdesk.cn/#download)).
  7. Let your AI agent work on your **other** computers.
  8. [RockDesk](https://rockdesk.io) gives every machine a 9-digit ID and connects them peer-to-peer, falling back to a relay when a direct path isn't possible. No port forwarding, no VPN setup, no sshd on the remote. Its command line, `rds`, lets an agent:
  9. - run commands on the other machine and get real exit codes (`shell -c`), or start long jobs that outlive the call
  10. - copy, sync and send files, or mount a remote folder as a local one
  11. - take screenshots it can read, then click, type and press keys
  12. - read and set the clipboard, browse clipboard history
  13. - forward TCP ports, serial ports and USB devices, or bring up a VPN into the remote's network
  14. This repository holds the skill that teaches agents to use it.
  15. Demo: [Claude Code drives a Windows PC](https://youtu.be/VIFOqMNGUW8) · [Claude Code drives a Mac](https://youtu.be/uddhlpvHFV0)
  16. ## Quickstart by AI Agent / Client
  17. | Agent / Client | Recommended Install |
  18. |---|---|
  19. | **Claude Code** | `claude mcp add -s user rockdesk -- rds mcp` or `/plugin install rockdesk --marketplace rockdesk-io/rockdesk-skill` |
  20. | **OpenAI Codex CLI** | `codex mcp add rockdesk -- rds mcp` or `codex plugin marketplace add rockdesk-io/rockdesk-skill` |
  21. | **Gemini CLI** | `gemini extensions install https://github.com/rockdesk-io/rockdesk-skill` |
  22. | **DeepSeek Harness (`dsh`)** | `dsh plugin --profile <profile> add github:rockdesk-io/rockdesk-skill` |
  23. | **TRAE / Cursor / Windsurf / Qwen** | `npx skills add rockdesk-io/rockdesk-skill` or stdio MCP `{"command": "rds", "args": ["mcp"]}` |
  24. | **WorkBuddy** | Search **RockDesk** in WorkBuddy Open Platform or install via `npx skills add rockdesk-io/rockdesk-skill` |
  25. ## Guides & Benchmarks
  26. - [Mac mini Remote Control & Bidirectional AI Hub](https://rockdesk.io/mac-mini-remote.html) — connect into your always-on Mac mini AND let Claude Code / Codex on it operate your Windows PC, Linux servers, laptops, and Android phones via `rds mcp`.
  27. - [1-RTT P2P FUSE Directory Mount vs SSHFS](https://rockdesk.io/vs-sshfs.html) — measured 4.8× faster small-file writes, 2.9× faster reads, and 35× faster `stat()` at 60 ms RTT.
  28. - [Remote Serial (`/dev/ttyUSB`), USB/IP, Headless ARM64 & ESP32-S3](https://rockdesk.io/remote-serial-usb.html) — remote hardware labs, Wake-on-LAN, GPIO, and physical touchscreen `ask` approval.
  29. - [RockDesk vs AnyDesk](https://rockdesk.io/vs-anydesk.html) · [RockDesk vs RustDesk](https://rockdesk.io/vs-rustdesk.html)
  30. ## Install
  31. ### 1. Install RockDesk on both machines
  32. [Download](https://rockdesk.io/#download) for Windows, macOS, Linux (x86_64 / arm64) and Android, plus an iOS client; in China use [rockdesk.cn](https://rockdesk.cn/#download). Install it on this computer and on every computer you want your agent to work on, and note the 9-digit ID the app shows there. New devices start with a free trial. On a Linux machine without a screen: `sudo systemctl enable --now rockd`, then `sudo rds otp` for a one-time password.
    • Warning: Sets up something that runs again on its own (cron, launchd, systemd, startup entry or shell profile) and fetches from the network
    • Line 47 on GitHub
  33. Direct links that always point to the newest release: [Windows](https://rockdesk.io/download/latest/windows) · [macOS, Apple silicon](https://rockdesk.io/download/latest/macos) · [macOS, Intel](https://rockdesk.io/download/latest/macos-x86_64) · [Linux x86_64 .deb](https://rockdesk.io/download/latest/linux-amd64) · [Linux arm64 .deb](https://rockdesk.io/download/latest/linux-arm64) · [Android .apk](https://rockdesk.io/download/latest/android). In China, use rockdesk.cn instead of rockdesk.io in these links. On macOS (Homebrew): `brew tap rockdesk-io/tap && brew install --cask rockdesk` ([homebrew-tap](https://github.com/rockdesk-io/homebrew-tap)). On Linux: `curl -fL -o rockdesk.deb https://rockdesk.io/download/latest/linux-amd64 && sudo apt install ./rockdesk.deb`.
  34. ### 2. Install the skill in your agent
  35. **Any agent, with the skills CLI** (puts it in `~/.agents/skills` and links it to the agents you pick):
  36. ```
  37. npx skills add rockdesk-io/rockdesk-skill
  38. ```
  39. **Claude Code, as a plugin** (2.1.275 or later, one step):
  40. ```
  41. /plugin install rockdesk --marketplace rockdesk-io/rockdesk-skill
  42. ```
  43. Older versions: `/plugin marketplace add rockdesk-io/rockdesk-skill`, then `/plugin install rockdesk@rockdesk`.
  44. The plugin lives in [`plugins/rockdesk/`](plugins/rockdesk/): Claude's plugin directory accepts only Markdown, text, JSON
  45. and images in a plugin folder, so it is kept apart from the files for other agents. Its copy of the skill is the same
  46. as [`skills/rockd-remote-control/SKILL.md`](skills/rockd-remote-control/SKILL.md) except that it points to the install
  47. guide instead of a one-line Linux install, and lets the user type passwords into `rds <id> auth` themselves.
  48. **Gemini CLI, as an extension:**
  49. ```
  50. gemini extensions install https://github.com/rockdesk-io/rockdesk-skill
  51. ```
  52. **DeepSeek Harness (dsh), as a plugin:** install it into the profile you use, then restart that profile:
  53. ```
  54. dsh plugin --profile <profile> add github:rockdesk-io/rockdesk-skill
  55. ```
  56. **Or just ask your agent** (Claude Code, Codex, DeepSeek Harness, …):
  57. ```
  58. Install the skill at https://rockdesk.io/rockdesk-cli.md
  59. ```
  60. **Codex, as a plugin:**
  61. ```
  62. codex plugin marketplace add rockdesk-io/rockdesk-skill
  63. codex plugin add rockdesk@rockdesk
  64. ```
  65. **Codex, skill only:** run this inside Codex, then restart it:
  66. ```
  67. $skill-installer install https://github.com/rockdesk-io/rockdesk-skill/tree/main/skills/rockd-remote-control
  68. ```
  69. **Or by hand:** copy `skills/rockd-remote-control/` into `~/.claude/skills/` (Claude Code), `~/.gemini/skills/` (Gemini CLI) or `~/.agents/skills/` (Codex, DeepSeek Harness — dsh does not read `~/.claude/skills`).
  70. **Or connect it as an MCP server** — use whichever you prefer. `rds mcp` (RockDesk 1.0.3 and later) is an MCP server over stdio with 18 tools: shell, spawn, copy, ls, screenshot, click, type_text, key, scroll, clipboard, port forwarding and more; screenshots come back as images.
  71. ```
  72. claude mcp add -s user rockdesk -- rds mcp # Claude Code
  73. codex mcp add rockdesk -- rds mcp # Codex
  74. ```
  75. Gemini CLI, Cursor, Claude Desktop and other MCP clients: `{"mcpServers": {"rockdesk": {"command": "rds", "args": ["mcp"]}}}`. On macOS and Windows `rds` is not on the PATH: use `/Applications/rockd.app/Contents/MacOS/rds` or `C:\Program Files\rockd\rds.exe`.
  76. If RockDesk isn't installed yet, the skill tells your agent to point you to the download page (or offer to install it for you).
  77. ## Things to ask
  78. - "123 456 789 is my office PC. How much space is left on C:, and how long has it been up?"
  79. - "On that Mac, open a Chrome guest window, fill in this form and copy what the server sends back here as order.json."
  80. - "Tail the service log on the robot computer and restart the service if it's stuck."
  81. - "Copy notes.txt to its desktop and open it."
  82. ## How it works
  83. `rds` never touches the network itself. It hands each command to the local RockDesk background service, which keeps one end-to-end encrypted connection per peer (QUIC, TLS 1.3) and reuses it for every later command: direct when NAT traversal works, through a relay otherwise. The relay only sees ciphertext.
  84. The machine being controlled decides who gets in: click to allow, a one-time password, a fixed password, or a key pair shared across your own devices. Your agent can only do what that machine allows.
  85. ## Data handling
  86. - Commands, files, screenshots and keystrokes go between your own machines over an end-to-end encrypted connection (QUIC, TLS 1.3). When there is no direct path they pass through a RockDesk relay, which only forwards ciphertext and stores nothing.
  87. - The RockDesk server sees what it needs to connect devices and check licenses: device IDs, network addresses, and your account email if you log in. It does not see session content.
  88. - The skill itself only runs the local `rds` command. It sends nothing to Anthropic or any other third party.
  89. ## Pricing
  90. Each device gets a 10-day free trial. After that see [pricing](https://rockdesk.io/pricing.html).
  91. ## License
  92. The skill file, plugin manifests and README in this repository are MIT-licensed ([LICENSE](LICENSE)). RockDesk itself is proprietary software.
  93. ## 中文
  94. **先在两台电脑上装好 RockDesk**(下载:[rockdesk.cn](https://rockdesk.cn/#download)):skill 只是教 AI 怎么用命令,真正干活的是 RockDesk。
  95. RockDesk 让 Claude Code、Codex、DeepSeek Harness 这些 AI 直接操作你的另一台电脑:跑命令、传文件、截屏、点鼠标、敲键盘,按 ID 点对点连接,不用开端口、不用配 VPN。
  96. 安装 skill:在 Claude Code 里输入 `/plugin marketplace add rockdesk-io/rockdesk-skill` 和 `/plugin install rockdesk@rockdesk`,或者直接跟 AI 说「安装 https://rockdesk.io/rockdesk-cli.md 这个 skill」;Codex 用 `codex plugin marketplace add rockdesk-io/rockdesk-skill` 和 `codex plugin add rockdesk@rockdesk` 装成插件(或者上面那条 `$skill-installer` 命令);Gemini CLI 用 `gemini extensions install https://github.com/rockdesk-io/rockdesk-skill` 装成扩展;DeepSeek Harness(dsh)用 `dsh plugin --profile <你的 profile> add github:rockdesk-io/rockdesk-skill` 装成插件,或者把 `skills/rockd-remote-control/` 拷到 `~/.agents/skills/`(dsh 不读 `~/.claude/skills`);也可以用 `npx skills add rockdesk-io/rockdesk-skill` 一条命令装好。不想装 skill 也行,直接接 MCP:`claude mcp add -s user rockdesk -- rds mcp`(Codex 是 `codex mcp add rockdesk -- rds mcp`),skill 和 MCP 爱用哪个用哪个。两台电脑都要装 RockDesk,国内从 [rockdesk.cn](https://rockdesk.cn/#download) 下载;固定的最新版直链是 `https://rockdesk.cn/download/latest/<平台>`,平台写 windows、macos、macos-x86_64、linux-amd64、linux-arm64 或 android。
  97. - **专题文档与实测**:[AI 远程控制总览](https://rockdesk.cn/ai-agents.html) · [Mac mini 双向 AI 中控指南](https://rockdesk.cn/mac-mini-remote.html) · [1-RTT 目录挂载对比 SSHFS(快 4.8–35 倍)](https://rockdesk.cn/vs-sshfs.html) · [远程串口 / USB / ARM64 / ESP32-S3](https://rockdesk.cn/remote-serial-usb.html)
  98. - **macOS Homebrew 一行安装**:`brew tap rockdesk-io/tap && brew install --cask rockdesk`;TRAE / WorkBuddy / 千问等支持 Skill 或标准 stdio MCP 的客户端均可直接通过 `npx skills add rockdesk-io/rockdesk-skill` 或 `rds mcp` 接入。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.