RockDesk MCP

P2P remote machine control for AI agents via 9-digit ID: persistent shell, 1-RTT FUSE mount, port/serial/USB forwarding & GUI control.

Documentation

RockDesk skill and MCP server for Claude Code, Codex, Gemini CLI, DeepSeek Harness and other agents

npx skills add rockdesk-io/rockdesk-skill

Needs the RockDesk app on both machines — the skill only teaches your agent the commands; RockDesk does the work. Download RockDesk (in China: rockdesk.cn).

Let your AI agent work on your other computers.

RockDesk 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:

  • run commands on the other machine and get real exit codes (shell -c), or start long jobs that outlive the call
  • copy, sync and send files, or mount a remote folder as a local one
  • take screenshots it can read, then click, type and press keys
  • read and set the clipboard, browse clipboard history
  • forward TCP ports, serial ports and USB devices, or bring up a VPN into the remote's network

This repository holds the skill that teaches agents to use it.

Demo: Claude Code drives a Windows PC · Claude Code drives a Mac

Install

1. Install RockDesk on both machines

Download for Windows, macOS, Linux (x86_64 / arm64) and Android, plus an iOS client; in China use rockdesk.cn. 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.

Direct links that always point to the newest release: Windows · macOS, Apple silicon · macOS, Intel · Linux x86_64 .deb · Linux arm64 .deb · Android .apk. 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). On Linux: curl -fL -o rockdesk.deb https://rockdesk.io/download/latest/linux-amd64 && sudo apt install ./rockdesk.deb.

2. Install the skill in your agent

Any agent, with the skills CLI (puts it in ~/.agents/skills and links it to the agents you pick):

npx skills add rockdesk-io/rockdesk-skill

Claude Code, as a plugin (2.1.275 or later, one step):

/plugin install rockdesk --marketplace rockdesk-io/rockdesk-skill

Older versions: /plugin marketplace add rockdesk-io/rockdesk-skill, then /plugin install rockdesk@rockdesk. The plugin lives in plugins/rockdesk/: Claude's plugin directory accepts only Markdown, text, JSON 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 as skills/rockd-remote-control/SKILL.md except that it points to the install guide instead of a one-line Linux install, and lets the user type passwords into rds <id> auth themselves.

Gemini CLI, as an extension:

gemini extensions install https://github.com/rockdesk-io/rockdesk-skill

DeepSeek Harness (dsh), as a plugin: install it into the profile you use, then restart that profile:

dsh plugin --profile <profile> add github:rockdesk-io/rockdesk-skill

Or just ask your agent (Claude Code, Codex, DeepSeek Harness, …):

Install the skill at https://rockdesk.io/rockdesk-cli.md

Codex, as a plugin:

codex plugin marketplace add rockdesk-io/rockdesk-skill
codex plugin add rockdesk@rockdesk

Codex, skill only: run this inside Codex, then restart it:

$skill-installer install https://github.com/rockdesk-io/rockdesk-skill/tree/main/skills/rockd-remote-control

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).

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.

claude mcp add -s user rockdesk -- rds mcp      # Claude Code
codex mcp add rockdesk -- rds mcp               # Codex

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.

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).

Things to ask

  • "123 456 789 is my office PC. How much space is left on C:, and how long has it been up?"
  • "On that Mac, open a Chrome guest window, fill in this form and copy what the server sends back here as order.json."
  • "Tail the service log on the robot computer and restart the service if it's stuck."
  • "Copy notes.txt to its desktop and open it."

How it works

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.

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.

Data handling

  • 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.
  • 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.
  • The skill itself only runs the local rds command. It sends nothing to Anthropic or any other third party.

Pricing

Each device gets a 10-day free trial. After that see pricing.

License

The skill file, plugin manifests and README in this repository are MIT-licensed (LICENSE). RockDesk itself is proprietary software.

中文

先在两台电脑上装好 RockDesk(下载:rockdesk.cn):skill 只是教 AI 怎么用命令,真正干活的是 RockDesk。

RockDesk 让 Claude Code、Codex、DeepSeek Harness 这些 AI 直接操作你的另一台电脑:跑命令、传文件、截屏、点鼠标、敲键盘,按 ID 点对点连接,不用开端口、不用配 VPN。

安装 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/latest/<平台>,平台写 windows、macos、macos-x86_64、linux-amd64、linux-arm64 或 android。