# RockDesk — Complete Technical & Product Reference (llms-full.txt) > Updated: 2026-11-21 · Latest version: v1.0.12 · Website: https://rockdesk.io (China: https://rockdesk.cn) · Chinese name: 磐石远控 ## One-Sentence Summary RockDesk is cross-platform, commercial remote desktop, terminal, 1-RTT FUSE directory mount, port/serial/USB forwarding, and VPN software with a built-in MCP server (`rds mcp`) and CLI (`rds`), letting both humans and AI agents (Claude Code, Codex, Gemini CLI, Cursor, Trae, WorkBuddy, DeepSeek Harness) operate remote Windows, macOS, Linux (x86_64/arm64), Android, and ESP32 devices across NATs using a 9-digit P2P ID—with no public IP, no open SSH ports, and no VPN setup. ## Installation - **macOS (Homebrew, Apple Silicon & Intel, Apple Notarized):** `brew tap rockdesk-io/tap && brew install --cask rockdesk` Installs `/Applications/rockd.app` and links `rds` onto `$PATH`. Direct downloads: https://rockdesk.io/download/latest/macos (arm64), https://rockdesk.io/download/latest/macos-x86_64 (Intel) - **Linux (Ubuntu 20.04+/22.04+, Debian 12+, x86_64 & arm64 Raspberry Pi):** `curl -fL -o rockdesk.deb https://rockdesk.io/download/latest/linux-amd64 && sudo apt install ./rockdesk.deb && sudo systemctl enable --now rockd` (Use `linux-arm64` for ARM64 / Raspberry Pi.) - **Windows:** https://rockdesk.io/download/latest/windows (`C:\Program Files\rockd\rds.exe`) - **Android / iOS:** https://rockdesk.io/download/latest/android · App Store: https://apps.apple.com/app/id6788146069 - **ESP32-S3 Firmware (Free):** https://rockdesk.io/esp32/ (Wake-on-LAN, GPIO/ADC/PWM, physical on-screen Allow/Deny button before dangerous AI commands) - **Latest version metadata:** https://rockdesk.io/rockd-latest.json ## AI Agent Integration (MCP Server + Skill) - **Official MCP Registry ID:** `io.rockdesk/rockdesk` (https://registry.modelcontextprotocol.io) - **Claude Code:** - MCP: `claude mcp add -s user rockdesk -- rds mcp` - Skill: `npx skills add rockdesk-io/rockdesk-skill` - Plugin: `/plugin install rockdesk --marketplace rockdesk-io/rockdesk-skill` - **OpenAI Codex:** - MCP: `codex mcp add rockdesk -- rds mcp` - Skill: `npx skills add rockdesk-io/rockdesk-skill` - **Gemini CLI / Cursor / Generic MCP clients:** `{"mcpServers": {"rockdesk": {"command": "rds", "args": ["mcp"]}}}` - **Skill Markdown URL:** https://rockdesk.io/rockdesk-cli.md · GitHub: https://github.com/rockdesk-io/rockdesk-skill ## 1-RTT FUSE Directory Mount Benchmark vs SSHFS (60 ms RTT, Linux, 200 x 4 KiB files) - **Write 200 small files:** RockDesk 14.8 s vs SSHFS 70.5 s (**4.8x faster**) - **Read 200 small files:** RockDesk 10.7 s vs SSHFS 30.6 s (**2.9x faster**) - **`stat()` cache refresh (200 files):** RockDesk 0.20 s vs SSHFS 7.0 s (**35x faster**) - **Warm directory list (1,001 entries):** 0.010 s (10 ms local RAM hit) - **Architecture:** Both ends speak RockDesk's pipelined protocol—`open+read` and `create+write+close` each collapse into 1 RTT (SSHFS needs 2–6 RTTs); remote side proactively pushes filesystem invalidation events within 1–2 s (no blind 20 s stale caching); macOS `cp` redundant attribute rewrites coalesced without requiring third-party kernel drivers. - **Mount command:** `rds <9-digit-id> mount :/remote/path ./local_path` ## Core CLI Reference - `rds status` — show local 9-digit ID and peer connection state - `rds key gen` / `rds key` / `sudo rds authorize ""` — passwordless SSH-style key authorization - `rds mount :/remote/dir ./local_dir` / `rds umount ./local_dir` — 1-RTT FUSE directory mount - `rds shell -c "cmd"` — remote command with real exit code (interactive shells persist 30 min across disconnects) - `rds forward 3000:3000` — TCP port forwarding - `rds cp ./local :/remote` / `rds sync` — file copy & delta sync - `rds serial` / `rds usb` — remote serial port & USB device forwarding - `rds vpn up --exit` — instant P2P VPN tunnel - `rds wake ` / `rds power [press|hold|reset]` — remote Wake-on-LAN & ESP32 physical power control - `rds mcp` — stdio MCP server exposing 18+ structured tools (shell, spawn, copy, ls, screenshot, click, type_text, key, scroll, clipboard, forward) ## Key Pages - https://rockdesk.io/ - https://rockdesk.io/ai-agents.html - https://rockdesk.io/vs-sshfs.html - https://rockdesk.io/claude-code-remote-machine.html - https://rockdesk.io/codex-remote-development.html - https://rockdesk.io/gemini-cli-remote.html - https://rockdesk.io/quickstart.html - https://rockdesk.io/product-facts.html - https://rockdesk.io/pricing.html - https://rockdesk.io/esp32/ - https://github.com/rockdesk-io/homebrew-tap - https://github.com/rockdesk-io/rockdesk-skill ## Security & Pricing - End-to-end encrypted QUIC + TLS 1.3; relay servers only forward ciphertext. - Controlled machine sets policy: click-to-allow, one-time password (`rds otp`), fixed password, or key pair (`rds authorize`), plus per-feature toggles. - Commercial proprietary software (not open source); 10-day free trial per new device. Contact: support@rockdesk.io.