OpenCode Cloud Link Documentation
OpenCode Cloud Link is a paid desktop and headless connector. It publishes the OpenCode server on your own machine — and the local services around it — to the OpenCode Mobile app and remote browsers over an authenticated Cloudflare Tunnel.
Your repository, provider credentials, prompts, and build tools stay on your machine. Cloud Link manages the connection so you can work from your phone without configuring a VPN, port forward, or tunnel.
Cloud Link is an independent project. It is not built by, endorsed by, or affiliated with the OpenCode team.
Choose your starting point
Section titled “Choose your starting point”| If you want to… | Start here |
|---|---|
| Understand what Cloud Link does | What is Cloud Link? |
| Install and connect for the first time | Quick start |
| Download the connector | Install overview |
| Pair a phone or approve a device | Pair with OpenCode Mobile |
| Learn the tray app and daily controls | User manual |
| Change a setting | Settings reference |
| Publish a dev server or dashboard | Exposed services |
| Fix a connection or pairing problem | Troubleshooting |
The shortest safe path
Section titled “The shortest safe path”- Install the connector on the machine that runs your OpenCode project.
- Open OpenCode Mobile → Settings → Cloud Link and subscribe or restore your purchase.
- Scan the connector’s QR code and approve the device on your machine.
- Open the machine in the app and start a small task.
If Cloud Link is new to you, read What is Cloud Link? first. If you already know the product, go straight to the quick start.
How the pieces fit
Section titled “How the pieces fit”| Piece | What it is | Where it runs |
|---|---|---|
| OpenCode Cloud Link | The connector that owns the tunnel and local proxy | Your computer or server |
| OpenCode | The coding agent that owns the project | On the same machine |
| OpenCode Mobile | The phone app that starts and reviews work | Android or iOS |
| Control plane | Pairing, entitlement, and tunnel metadata | Cloudflare |
| Cloudflare Tunnel | The encrypted public path to the connector | Cloudflare edge |
The control plane establishes the connection and then gets out of the way. OpenCode traffic flows between the app and your machine; it is not stored by the control plane.
Platform support
Section titled “Platform support”- macOS 15 or newer, Apple silicon and Intel (one universal DMG).
- Windows x64 (desktop tray app; the installer is currently unsigned).
- Linux x64 and ARM64 (headless archive with an optional systemd user service).
Each download includes pinned OpenCode and cloudflared. No Go, Rust, Node, or Cloudflare account is required at runtime. See install requirements for the full matrix.
Get help
Section titled “Get help”- Troubleshooting covers pairing, services, authentication, and platform failures.
- FAQ answers the most common product questions.
- For AI assistants lists canonical facts and machine-readable endpoints.
- For phone-side features beyond Cloud Link, use the OpenCode Mobile documentation.
OpenCode Cloud Link is an independent project. It is not built by the OpenCode team and is not affiliated with them in any way. See thePrivacy Policy andTerms & Conditions.