Gemini CLI Remote Machine Control via Built-in MCP & 9-Digit ID
Wire RockDesk into Gemini CLI in 30 seconds: control remote Macs, headless Linux servers, Windows machines, Raspberry Pis, and ESP32 hardware over encrypted P2P QUIC with zero open ports.
rds mcp) to Gemini CLI and control remote Macs, headless Linux servers, Windows PCs, Raspberry Pis, and ESP32 boards across NATs by 9-digit P2P ID—no public IP, no VPN, and 1-RTT FUSE folder mounting up to 35× faster than SSHFS.
Configure RockDesk MCP in Gemini CLI
Add the following entry to your Gemini CLI MCP settings (~/.gemini/settings.json), and optionally install the companion skill:
{
"mcpServers": {
"rockdesk": {
"command": "rds",
"args": ["mcp"]
}
}
}
# Install RockDesk on macOS (auto-links rds to PATH)
brew tap rockdesk-io/tap && brew install --cask rockdesk
# Install the RockDesk skill for Gemini CLI
npx skills add rockdesk-io/rockdesk-skill
Capabilities Available to Gemini CLI
| Capability | Command / MCP Tool | Key Advantage |
|---|---|---|
| Remote command execution | rds <id> shell -c "..." / shell | Real exit codes, 30-min persistent sessions across disconnects |
| 1-RTT FUSE folder mount | rds <id> mount :/path ./local | 4.8× faster small-file writes & 35× faster stat() vs SSHFS |
| Port, serial & USB forwarding | forward / serial / usb | Access remote web UIs & embedded boards locally |
| Visual GUI automation | screenshot / click / type_text | Drive native macOS / Windows desktop apps headlessly |
| Physical hardware control | wake / power (ESP32-S3) | Wake LAN PCs, toggle GPIO, require physical button confirmation |
Frequently asked questions
How do I add RockDesk to Gemini CLI?
Install RockDesk on both machines (on macOS: brew tap rockdesk-io/tap && brew install --cask rockdesk), add {"mcpServers":{"rockdesk":{"command":"rds","args":["mcp"]}}} to ~/.gemini/settings.json, and optionally run npx skills add rockdesk-io/rockdesk-skill.
Does Gemini CLI need SSH access or a VPN to reach my home Mac mini or Linux box?
No. RockDesk connects peer-to-peer using a 9-digit device ID over end-to-end encrypted QUIC + TLS 1.3, punching through NAT automatically with encrypted relay fallback.
Is RockDesk open source?
RockDesk is commercial proprietary software with a 10-day free trial per device, designed for reliable cross-platform maintenance without ads or forced paywall popups. Its agent skill repository and Homebrew tap are public on GitHub.
Try RockDesk free for 10 days per device
Windows, macOS (Apple silicon & Intel), Linux (x86_64 & arm64), Android & ESP32. Install on macOS via brew tap rockdesk-io/tap && brew install --cask rockdesk.