Phone Handoff
Codux Mobile pairs with the desktop host so you can step away from the desk and keep going on your phone. The desktop app always stays the real terminal host. Pairing and transport run over Iroh: the phone takes a direct peer-to-peer path when the network allows it, and falls back to a relay otherwise.
Components
Section titled “Components”| Component | Purpose | Download |
|---|---|---|
| Codux Desktop | Main app for projects, terminals, Git, stats, memory, and remote hosting. | Desktop Releases |
| Codux Mobile | Android and iOS companion: pair with the desktop, share split terminals, browse and edit text files, upload images. | Mobile Releases |
| Relay (optional) | Helps the two devices connect over Iroh when a direct path is unavailable. Just choose a node in settings. | Relay Guide |
Choosing a relay
Section titled “Choosing a relay”In Settings → Remote, the relay is a simple choice — there is no address to copy around:
| Option | When to use |
|---|---|
| Global | The default. Works out of the box, no setup. |
| China (Tencent Cloud) / China (Alibaba Cloud) | A faster path for users in China. Built in — just select it. |
| Custom | Point Codux at your own node. See the Relay Guide. |
After changing the relay, pair the mobile client again so the QR code reflects the new network path.
What you can drive from mobile
Section titled “What you can drive from mobile”The desktop host exposes these remote operations:
- Projects — list, select, add, edit, remove.
- Terminals — list, create, input, resize, interrupt/escape, close, and buffer replay.
- Worktrees — list, select, create, merge, remove.
- Files — list, read/write UTF-8 text (up to 2 MB), create directory, same-directory rename, delete, plus binary-safe copy/move.
- Git — status and the same Git operations the desktop panel runs.
- AI — per-project stats (live sessions, heatmap, time buckets, tool and model breakdowns), live AI state, and session actions.
- SSH — manage SSH connection profiles.
Image uploads are written to a temporary upload folder on the host and inserted into the active terminal as a file path.
Transport: direct first
Section titled “Transport: direct first”Codux Mobile starts from a short-lived pairing code generated by the desktop app. After pairing, the connection prefers a direct peer-to-peer path over Iroh; when a direct path is unavailable, the same protocol continues through the relay you selected.
Pairing
Section titled “Pairing”The desktop generates a short-lived pairing code and QR (valid for about 10 minutes). Because presenting the QR already proves you hold its one-time secret, pairing is auto-confirmed — there is no operator dialog, and no credentials leave the host.
Encryption model
Section titled “Encryption model”All traffic rides Iroh’s encrypted QUIC connection, authenticated by each device’s node identity. The relay only helps the two devices find each other and forwards opaque encrypted packets when a direct path is unavailable — it never becomes the host and never sees your decrypted content.
For teams that need a private or regional path, point Codux at a custom relay node. For most users, Global works without any setup.