iOS 應用程式

cmux iOS 應用程式是你 Mac 的配套應用程式。將 iPhone 或 iPad 與執行 cmux 的 Mac 配對，即可從手機連線到你的終端，並可選擇轉發終端通知。

Set up cmux on iPhone and iPad

取得存取權限

該應用程式透過 TestFlight 發布。cmux Founders Edition 包含搶先存取權限，以及其他早期功能。

Set up cmux on iPhone and iPad

cmux on iOS connects to cmux running on your Mac. Your shells and agents continue running on the Mac while you view and control their workspaces from your phone or tablet.

Before you start

• Install the latest cmux on your Mac and keep it open with at least one workspace. If the phone requests a newer Mac version, update the specific cmux app you are connecting to.
• Install cmux on your iPhone or iPad. For the beta, accept your TestFlight invitation and install cmux BETA through TestFlight.
• Have both devices connected to the internet and use the same cmux account. If you use teams, select the same team on both devices.

Download cmux for Mac · Get cmux for iOS

1. Enable pairing on your Mac

1. Open cmux on the Mac and sign in to your cmux account.
2. Open cmux Settings, select Mobile, and turn on Enable iOS pairing. Do this in each cmux Mac app you want to access from your phone.
3. Keep cmux running and the Mac awake. If the Mac sleeps, shuts down, or loses its connection, the phone cannot reach its terminals.

2. Sign in and connect from iOS

1. Open cmux on your iPhone or iPad and sign in with the same cmux account as the Mac. Check the email on both devices if you have more than one account.
2. Follow the introduction. Enable Notifications when asked, or choose Not Now and enable them later. On the pairing page, confirm that you enabled iOS pairing on your Mac.
3. Choose Auto-Connect and tap Check for My Mac. This discovers compatible Macs signed in to your account. Auto-Connect does not require you to install Tailscale.
4. When the Mac is connected, tap Open Workspaces. Choose a workspace, then a terminal to view output and send input. Use All Computers at the top to change the selected Mac.

Optional: connect with Tailscale Only

1. Install Tailscale on the Mac and iPhone or iPad, sign both into the same Tailscale network, and confirm Tailscale is connected on both.
2. Keep Enable iOS pairing on in cmux Settings > Mobile. On iOS, select Tailscale Only in the connection options, then choose Scan Pairing Code.
3. Open Mobile Connect in cmux on the Mac and scan its pairing code with the phone. Allow camera access when requested and follow the pairing prompts.
4. Keep Tailscale connected on both devices when using this mode, including when the phone switches from Wi-Fi to cellular. Your Tailscale access rules must allow the phone to reach the Mac.

3. Enable agent notifications

1. Tap Enable Notifications during the introduction and allow notifications in the iOS prompt. If you skipped or denied it, open iOS Settings > Notifications > cmux and enable Allow Notifications.
2. Check notification settings in cmux on both devices and enable forwarding where offered. Keep the Mac running and connected so it can send new agent alerts.
3. Open a workspace with a configured coding agent and trigger an alert. Check the Notifications tab in cmux, then check delivery to your phone. Focus modes and Scheduled Summary can delay or silence alerts.

Configure terminal and agent notifications

4. Verify your connection

1. Open a terminal from the phone and run a harmless command such as pwd. Confirm the output appears on the phone and in the same Mac workspace.
2. Switch to another workspace, then return. If you plan to connect away from home, test on cellular before leaving the Mac.
3. Keep the Mac plugged in and awake for remote access. A keep-awake option may be offered during setup; use it if you want the Mac to remain reachable.

If no workspaces appear

After correcting a setup issue, return to Workspaces and tap Retry. Retry reconnects to a saved Mac or refreshes the workspace list and account-backed connection information.

The Mac is missing

Check Enable iOS pairing in Settings > Mobile on the exact Mac app you opened. Confirm the same cmux account and team on both devices, and keep that Mac app running. Use the Computers button to inspect available Macs and check whether you hid the computer.

cmux asks for a newer Mac app

Update cmux on the Mac, then quit and reopen that app. If you run several cmux versions, confirm the phone is selecting the updated one. Follow the minimum version shown by the iOS app.

The Mac appears but will not connect

Wake the Mac and check internet access on both devices. Allow Local Network access on iOS if requested. For Tailscale Only, check that both Tailscale apps are connected to the same network and that access rules permit the connection. Then tap Retry.

The connection works but the list is empty

Create or open a workspace in cmux on the Mac. On the phone, choose All Computers and clear workspace search or filters. Pull down to refresh the list, or tap Retry in the empty state.

Still need help?

Include your cmux versions on Mac and iOS, your connection mode, the exact error, and whether the Mac appears under Computers. Never include passwords or pairing codes.

Contact cmux support

先決條件

開始之前，你需要：

• 一台執行 cmux 並已登入的 Mac。
• 一台已從 TestFlight 安裝 cmux BETA 應用程式的 iPhone 或 iPad。
• 從手機到 Mac 的網路路徑（參見下方的自帶網路）。

自帶網路

cmux 不提供開箱即用的網路。終端串流在你的手機和 Mac 之間直接傳輸，因此你的手機必須能夠在網路上連線到你的 Mac。最簡單的方式是使用私有覆蓋網路。

Tailscale（建議）

在你的 Mac 和手機上都安裝 Tailscale，並登入到同一個 tailnet。這樣你的手機就可以從任何地方透過 Mac 的 tailnet 位址連線到它，無需連接埠轉發。

WireGuard

如果你已經在執行 WireGuard，將你的 Mac 和手機置於同一網路，並使用 Mac 的 WireGuard 位址。

配對與連線

1. 在 Mac 上，開啟 cmux 中的 Mobile Connect 視窗。
2. 在你的手機上，開啟 cmux BETA 應用程式並確認 Mobile Connect 中顯示的配對。
3. 配對完成後，你的工作區和終端會透過你的網路出現在手機上。

配對是按裝置進行的。新裝置或重新安裝的應用程式需要再次配對。

通知

你可以選擇將終端通知轉發到手機，這樣需要關注的面板就會推送到你的裝置。開啟轉發後，通知文字（標題和內文，取自終端輸出）會透過 cmux 伺服器傳送到 Apple 的推送服務以進行投遞。在通知設定中開啟 Hide content，即可改為傳送通用訊息，並將終端文字保留在你的裝置上。請參閱 通知 了解 cmux 如何觸發它們。

儲存哪些資料

cmux 的設計讓你的終端只在你的裝置之間流轉。在 cmux 伺服器上，我們只儲存登入你的帳戶和連線你的裝置所需的內容：

• 你登入時的帳戶（電子郵件），用於在各裝置間識別你。
• 你裝置的推送權杖，用於投遞轉發的終端通知。
• 配對和裝置中繼資料，用於將你的手機連線到你的 Mac。

企業與自架

如需自架或氣隙隔離部署，請聯絡 founders@cmux.com。