rockdesk
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/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
- {
- "name": "rockdesk",
- "owner": {
- "name": "RockDesk",
- "email": "dev@rockdesk.io"
- },
- "metadata": {
- "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)."
- },
- "plugins": [
- {
- "name": "rockdesk",
- "displayName": "RockDesk",
- "source": "./plugins/rockdesk",
- "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).",
- "version": "1.0.17",
- "author": {
- "name": "RockDesk",
- "email": "dev@rockdesk.io"
- },
- "homepage": "https://rockdesk.io",
- "category": "productivity"
- }
- ]
- }
README.md · README · 151 lines · 1 finding marked
- # RockDesk skill and MCP server for Claude Code, Codex, Gemini CLI, DeepSeek Harness and other agents
- [](https://mcpservers.org/servers/rockdesk-io/rockdesk-skill) [](https://rockdesk.io/ai-agents.html) [](https://open-vsx.org/extension/rockdesk/rockdesk) [](https://github.com/rockdesk-io/homebrew-tap)
- ```
- 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](https://rockdesk.io/#download) (in China: [rockdesk.cn](https://rockdesk.cn/#download)).
- Let your AI agent work on your **other** computers.
- [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:
- - 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](https://youtu.be/VIFOqMNGUW8) · [Claude Code drives a Mac](https://youtu.be/uddhlpvHFV0)
- ## Quickstart by AI Agent / Client
- | 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` |
- ## Guides & Benchmarks
- - [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`.
- - [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.
- - [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.
- - [RockDesk vs AnyDesk](https://rockdesk.io/vs-anydesk.html) · [RockDesk vs RustDesk](https://rockdesk.io/vs-rustdesk.html)
- ## Install
- ### 1. Install RockDesk on both machines
- [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
- 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`.
- ### 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/`](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`](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](https://rockdesk.io/pricing.html).
- ## License
- The skill file, plugin manifests and README in this repository are MIT-licensed ([LICENSE](LICENSE)). RockDesk itself is proprietary software.
- ## 中文
- **先在两台电脑上装好 RockDesk**(下载:[rockdesk.cn](https://rockdesk.cn/#download)):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) 下载;固定的最新版直链是 `https://rockdesk.cn/download/latest/<平台>`,平台写 windows、macos、macos-x86_64、linux-amd64、linux-arm64 或 android。
- - **专题文档与实测**:[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)
- - **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 inFree to use. If it’s helped, pass it on.