3-minute quickstart
Install RockDesk on two machines and connect by ID. Remote desktop, terminal, files and forwarding all ride that one connection — and your AI agent can use it too.
1Install it on both machines
- Windows: run the installer from the download section. It is not code-signed yet, so Windows may say “Windows protected your PC” — click More info → Run anyway.
- macOS (Apple silicon or Intel, one download each): open the .dmg and drag the app into Applications.
- Linux (Ubuntu 20.04 or later):
sudo apt install ./rockdesk-*-linux-amd64.deb - Android: install the .apk. iPhone / iPad: “RockDesk Remote” on the App Store (free), for reaching your computers.
- Nothing to install at all: open the web version in a browser.
2On the machine you’ll reach: decide who gets in
Open RockDesk. The home screen shows this machine’s 9-digit ID and a one-time password — that is all the other side needs (new installs from 1.0.6 have it on). In Settings → Who can connect you choose the ways in:
- One-time password — on by default, shown on the home screen, changes after every use. Works when nobody is at that machine.
- Allow when someone connects — a dialog pops up when someone connects; nothing happens until a person there clicks Allow.
- Fixed password / key pair — for your own machines: type it once and they remember it (key pairs work like ssh).
3Connect from the other one
Type the other machine’s ID → Connect → enter the one-time password (or have someone there click Allow). The first connection takes a second or two to punch through; after that, desktop, terminal, files and forwards open instantly.
4Let your AI agent use it
RockDesk ships rds, a command line that does everything the app does, and a skill that teaches coding agents how to use it. In Claude Code (or a similar agent), say this once in the chat — it installs the skill itself:
Install the skill at https://rockdesk.io/rockdesk-cli.md
The agent uses rds (the skill file is rockdesk-cli.md). On macOS rds is /Applications/rockd.app/Contents/MacOS/rds; on Windows, "C:\Program Files\rockd\rds.exe". Then just ask:
“Take a screenshot of 123456789, open Settings and turn on dark mode.”
“Copy ~/build/app.zip to 123456789 and unzip it in Downloads.”
The agent gets exactly what the other machine allows you — nothing more.
5Or use the command line yourself
rds 123456789 shell -c "df -h" # run a command, get its exit code
rds 123456789 cp ./build.zip :~/build.zip # copy (':' marks the remote side)
rds 123456789 mount :/home/me/proj ~/proj # mount a remote folder
rds 123456789 forward 15432:5432 # remote Postgres on local port 15432
rds 123456789 vpn up # VPN into the other side
Everything else is in the CLI guide.
FAQ
- It won’t connect.
- Both machines need RockDesk running and internet access. Check step 2 on the machine you are reaching. When a direct path is impossible, RockDesk falls back to a relay (China and the US) automatically — slower, but it works.
- Is it secure?
- Each device has its own certificate and every connection is end-to-end encrypted (QUIC + TLS 1.3). Our servers only introduce the two ends and relay ciphertext. Who can connect, and to which features, is decided on the machine being reached.
- What does it cost?
- Each device gets a 10-day free trial from first use; after that, buy days, a month or a year on the pricing page.
- Something else?
- Write to [email protected] — a person reads every message.
三分钟上手
两台电脑装上 RockDesk,输对方的 ID 就连上。远程桌面、终端、文件、转发都走这一条连接,AI 也能直接用。
1两台都装上
- Windows:在下载区下安装包运行。安装包暂时还没做代码签名,可能提示「Windows 已保护你的电脑」,点更多信息 →仍要运行。
- macOS(Apple 芯片、Intel 各一个包):打开 .dmg,把 app 拖进「应用程序」。
- Linux(Ubuntu 20.04 起):
sudo apt install ./rockdesk-*-linux-amd64.deb - 安卓:装 .apk。iPhone / iPad:App Store 搜「RockDesk Remote」(免费),用来连你的电脑。
- 什么都不想装:浏览器打开网页版也能连。
2在要被连的那台:定好谁能连
打开 RockDesk,首页上是这台的 9 位 ID 和临时密码,对方有这两样就能连(1.0.6 起新装默认开着)。连进来的办法在 设置 →「谁能连我」 里选:
- 临时密码:默认开着,首页上显示,用一次换一个。人不在那台电脑前也能连。
- 连接时允许:有人连进来时弹窗,那边的人点「允许」才行。
- 固定密码 / 密钥对:给自己的几台电脑用,输一次就记住(密钥对跟 ssh 一样)。
3从另一台连过去
输入对方的 ID → 连接 → 输临时密码(或者让那边的人点「允许」)。第一次要一两秒打洞,之后远程桌面、终端、文件、转发都是秒开。
4让 AI 用起来
RockDesk 带着命令行 rds(界面能做的它都能做),还有一份教 AI 用它的 Skill。在 Claude Code 这类 AI 工具的对话框里说这一句,它自己就装好了:
安装下 https://rockdesk.cn/rockdesk-cli.md 这个 skill
AI 用的是命令行 rds(Skill 文件是 rockdesk-cli.md)。macOS 上 rds 在 /Applications/rockd.app/Contents/MacOS/rds;Windows 是 "C:\Program Files\rockd\rds.exe"。然后直接说:
「把 123456789 的屏幕截个图,打开设置,把深色模式打开。」
「把 ~/build/app.zip 拷到 123456789,在它的下载目录里解压。」
对方那台允许你做什么,AI 就只能做什么。
5自己用命令行也行
rds 123456789 shell -c "df -h" # 跑命令,退出码跟对方一样
rds 123456789 cp ./build.zip :~/build.zip # 拷文件(冒号表示对方那边)
rds 123456789 mount :/home/me/proj ~/proj # 把对方的目录挂到本机
rds 123456789 forward 15432:5432 # 对方的 Postgres 映射到本机 15432
rds 123456789 vpn up # 内网穿透到对方
完整用法见 命令行说明。
常见问题
- 连不上?
- 两边都要开着 RockDesk、能上网;再看看被连那台第 2 步开了没有。打不通直连会自动走中继(国内、美国都有节点),慢一点但能用。
- 安全吗?
- 每台设备一张证书,每条连接都端到端加密(QUIC + TLS 1.3),服务器只牵线、转发密文。谁能连、能用哪些功能,由被连的那台决定。
- 要钱吗?
- 每台设备从第一次用起免费试用 10 天,之后按天、月、年买,见价格页。
- 别的问题?
- 写信到 [email protected],每封都有人看。