Cmux Remote
English简体中文
Get started
Cmux Remote · iOS / AndroidiPhone + Android

Your Cmux agents.
A graphical client.

Use Claude Code and Codex in Cmux through a graphical conversation interface on iPhone and Android. Send tasks, follow tool activity, inspect code changes, and answer questions to keep development moving.

Install Cmux Remote for iOS Download for Android
Watch the complete workflow
Conversations & tools · Files & diffs · Start & resumeIndependent open-source project. Not an official Cmux product.
ONE AGENT. PICK UP ANYWHERE.Connection overview

Agents on your Mac.
Control in your hand.

Code and environment on Mac.
Conversations and changes on your phone.

REMOTE HOST

The Mac running your agents

CmuxCompanion
storefront Code · Environment · Agents
Claude CodeCodexDev environment
Conversations & tools → PhoneFiles & diffs → PhoneQuestions & permissions → Phone

Your code, environment, and agents keep running here

Cmux — Remote
WORKSPACES
local-project
REMOTE
storefront
api-server
↗ remote-mac
Claude ~/projects/storefront
❯ Add an empty checkout state and run tests

● Read src/checkout.tsx
● Edit src/checkout.tsx

Added the empty cart state.
Tests passed. Changes are ready to review.

2 files changed · +24 −6

❯
9:41▥ ▰
‹
Checkout improvementsremote-mac · Claude
···
Add an empty state and run tests
✳ Claude

Empty state added. Tests passed.

⌘ Updated 2 files ⌄

Review the changes or add your next instruction.

Response complete
What's next…↑
Mac · Code, environment & agentsiPhone · Graphical conversations
Remote execution. Interaction within reach.Illustrative devices and interface
01 / Core features

From the first prompt
to the final diff.

Complete an Agent workflow on your phone.
Conversations, tool records, and changes have their own mobile interface.

A complete Agent workflow
01

Give the task. Keep the conversation.

Send a new request, add context, or attach an image. Stop the current task when you need to change direction, then explain what comes next.

02

See the work and its results.

Read replies, expand tool inputs and outputs, and inspect test results, images, and code diffs. Open the details when you need them.

03

Answer and move forward.

Choose an answer, add a note, or confirm an action in supported question and permission cards to keep a waiting task moving.

Install Cmux Remote for iOS
‹
Checkout improvementsremote-mac / storefront
···
Add an empty checkout state and run tests.
✳ Claude Code

The empty cart state is ready, and tests are complete.

Updated 2 files⌄

An empty cart now shows a message and a Continue shopping button.

Tests passed
Example response · Complete
What's next…↑
Conversation UI detailClaude / Codex
Demo coming soon
A complete workflow, from the first prompt to reviewing the resultDemo 01
02 / Task management

Start on your phone.
Run on your Mac.

Choose an approved Mac, workspace, and project folder.
Start something new, or pick up an existing conversation.

Start & resume

Start a task. Resume a conversation.

Launch Claude Code or Codex with your first request. When an existing conversation has ended, resume it with its context when supported.

New conversation
Computer
Development Mac
Workspace
storefront
Project folder
~/projects/storefront
Agent
Claude Code / Codex
Add an empty state to checkout, then run the tests.

Interface illustration · Runs on the selected Mac

Conversations & tasks

Keep your projects in view.

Switch between Macs, workspaces, and conversations. Find running tasks and pending questions, and open background-task records to see what happened.

Workspaces & conversations
Checkout empty stateRunning
API testsNeeds an answer
Documentation updateCompleted

Pick up a long conversation.

Pages you have read stay on your phone. Reopening shows the saved copy first, then updates it from the Mac. Load earlier records as you read back.

Interface illustration · Macs, workspaces & background tasks

03 / Compare

Choose your way
to work on mobile.

The official Cmux mobile client offers remote terminal control.
Cmux Remote organizes its interface around Claude Code and Codex conversations.

CompareOfficial Cmux mobile clientCmux Remote
Primary interactionThe product page emphasizes live terminal mirroring, workspace switching, and a full keyboard.Structured conversations, tool cards, question cards, and diffs are the primary interface.
Agent coverageTerminal mode works with a broad range of command-line agents and TUI programs.Structured controls focus on Claude Code and Codex.
Mobile platformsPublicly offers an iPhone / iPad entry point.Offers iOS and Android clients.
PairingThe documented Mac pairing flow includes account-based connections.No project account. Request access by QR code and approve the device on the Mac.
Remote accessOffers connection options including Auto-Connect and Tailscale Only.Connect over a reachable network, or deploy your own Cloudflare relay.

The official source also includes chat-related interfaces. This compares the primary interaction and connection choices; capabilities depend on the version you use.

Official product page Official connection guide Official chat interface
04 / Connections

Connect nearby.
Reach it from outside.

Discover and pair with your Mac on the local network.
Use an existing network or your own relay when you are away.

Local network

Find a nearby Mac.

Discover your Mac on networks that support service discovery. Confirm the device and workspace access before connecting.

PhoneMac
Nearby discovery · Direct connection
VPN / Tailscale

Reach your remote Mac.

Use an existing VPN or Tailscale network. If discovery is unavailable, add the address and pair manually.

PhoneMac
Your network · Direct connection
Self-hosted relay

Reach beyond direct access.

The Mac and phone connect outward to your Cloudflare relay. The Mac needs no public inbound port.

PhoneYour relayMac
Relay deployment guide

Approve each device, scope access by workspace, and revoke it individually. Discovery depends on your network. Deploy and manage your own relay; this project does not provide a hosted relay service.

05 / Get started

Connect your Mac.
Open your first task.

Set up once to reach the development environment you already use.

01

Prepare your Mac

Install and run Cmux and Cmux Remote. Turn on sharing and choose the workspaces the device may access.

02

Pair your phone

Install the iOS or Android client, scan the pairing code, and approve the device on your Mac.

03

Start working

Open an existing conversation or start a task in an approved project folder. Set up a network path or your own relay for remote access.

Download Cmux Remote for Mac Install Cmux Remote for iOS Download for Android

Mac: macOS 14 or later · iPhone: iOS 18 or later · Android: Android 10 or later. Install iOS through TestFlight and the Android APK from GitHub Releases.

06 / Open source & independent

Your existing agents.
Your development environment.

Cmux Remote runs independently alongside official Cmux, without modifying or replacing it or creating a separate model service. Your computer’s agents keep running with their existing environment and configuration.

View source on GitHub Privacy policy
Open-source clients, Mac Companion, and relay
No project account. No analytics.
Code, environment, and agents stay on your Mac
Independent. Not an official Cmux product.
FAQ

Before you begin,
a few answers.

Which agents and actions are supported?

Structured conversations focus on Claude Code and Codex. Send prompts, read history and tool records, inspect files and diffs, stop tasks, and answer supported questions and permissions. Approved devices can also start conversations or resume eligible ones.

Does the Mac need to stay running and awake?

Yes. Agents run on the Mac, and Cmux and Cmux Remote must remain available. If the Mac sleeps, shuts down, or goes offline, the phone cannot read live updates or control tasks.

Do I need a relay when I am away?

Not always. Connect directly when an existing VPN, Tailscale, or another reachable network provides access to the Mac. Otherwise, deploy your own Cloudflare relay. This project does not provide a hosted relay service.

How do I grant or revoke access?

Request pairing from the phone, then approve that device and select its workspaces on the Mac. Revoke each device individually; changes to its access scope require approval on the Mac.

How does saved history differ from live status?

Conversation pages you have read are saved on the phone so you can see them when reopening. Live updates and actions still require a connection to the Mac. Saved history does not establish a task’s current state.

Can I connect from another Mac?

Use Companion workspace mirroring for approved remote terminal workspaces, or use the native Cmux cmux ssh command. Their capabilities differ from mobile structured conversations. Read the Mac connection guide