OpenAI Codex Remote Development via 9-Digit P2P ID & MCP
Give local OpenAI Codex reliable, zero-tunnel access to remote Linux servers, Macs, Windows PCs, and ARM boards—with built-in MCP (rds mcp), 1-RTT FUSE mount, and persistent shells.
codex mcp add rockdesk -- rds mcp and address any Mac, Linux server, Windows PC, or ARM board by a persistent 9-digit P2P ID.
Why Codex Developers Pair Local Codex with RockDesk
Zero SSH Tunnel Maintenance
Remote boxes hold a persistent 9-digit ID and reconnect automatically to the RockDesk broker on boot. No manual tunnel restarts when a VM, Mac mini, or sandbox reboots.
1-RTT Local Directory Mount
Mount remote codebases locally via rds <id> mount :/srv/app ./app—4.8× faster small-file writes and 35× faster stat() refreshes than SSHFS over a 60 ms link.
Persistent Remote Shells
rds <id> shell -c "..." returns real exit codes and stdout/stderr; interactive sessions stay alive for 30 minutes across network switches so long builds never die mid-flight.
Full Hardware & Port Forwarding
Forward remote TCP ports (rds <id> forward 3000:3000), remote serial ports (rds <id> serial), or USB devices directly to your laptop.
Connect OpenAI Codex in 2 Commands
# 1. Install RockDesk on macOS (or Linux/Windows via rockdesk.io/#download)
brew tap rockdesk-io/tap && brew install --cask rockdesk
# 2. Register the built-in MCP server and agent skill in Codex
codex mcp add rockdesk -- rds mcp
npx skills add rockdesk-io/rockdesk-skill
Once registered, prompt Codex naturally: "Mount :/srv/api from 987654321 to ./api, refactor the webhook handler, run cargo test on 987654321, and forward port 8080 so I can test it locally."
Frequently asked questions
How do I connect OpenAI Codex CLI to RockDesk?
Install RockDesk on both machines, then run codex mcp add rockdesk -- rds mcp (and optionally npx skills add rockdesk-io/rockdesk-skill). Codex immediately gains access to remote shell, file copy/sync, folder mount, port forwarding, and GUI tools.
What happens when a remote sandbox or server reboots?
Because the rockd systemd service starts automatically on boot and re-registers the same 9-digit ID, Codex can immediately reuse that ID without you manually recreating SSH tunnels.
Does RockDesk work on ARM64 Linux servers and Raspberry Pi?
Yes. Official linux-arm64.deb packages support Ubuntu 22.04+ and Debian 12+ on Raspberry Pi, Jetson, and ARM cloud servers.
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.