GEMINI CLI REMOTE WORKFLOW

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.

Updated 2026-11-21 · RockDesk v1.0.12 · End-to-end encrypted QUIC + TLS 1.3
Give Gemini CLI hands on every machine you own: Add RockDesk's built-in stdio MCP server (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

CapabilityCommand / MCP ToolKey Advantage
Remote command executionrds <id> shell -c "..." / shellReal exit codes, 30-min persistent sessions across disconnects
1-RTT FUSE folder mountrds <id> mount :/path ./local4.8× faster small-file writes & 35× faster stat() vs SSHFS
Port, serial & USB forwardingforward / serial / usbAccess remote web UIs & embedded boards locally
Visual GUI automationscreenshot / click / type_textDrive native macOS / Windows desktop apps headlessly
Physical hardware controlwake / 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.

Download RockDeskSkill & MCP Docs