# App para iOS

La app de cmux para iOS es un complemento para tu Mac. Empareja tu iPhone o iPad con un Mac que ejecute cmux y conéctate a tus terminales desde el teléfono, con reenvío opcional de las notificaciones de la terminal.

[Set up cmux on iPhone and iPad](https://cmux.com/es/docs/ios#setup)

La app para iOS está en beta. Se distribuye en TestFlight como cmux BETA.

## Obtener acceso

La app se distribuye a través de TestFlight. El acceso anticipado se incluye con [cmux Founders Edition](https://github.com/manaflow-ai/cmux#founders-edition), junto con otras funciones tempranas.

## 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](https://cmux.com/es) · [Get cmux for iOS](https://cmux.com/es/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.

Pairing is off by default. While it is off, that Mac stays hidden from iOS. Signing in alone does not enable pairing.

### 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.

Allow Local Network access if iOS asks. If you previously denied it, open the iPhone or iPad Settings app, find cmux, and enable Local Network. Then return to cmux and tap Retry.

### 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](https://cmux.com/es/docs/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](https://cmux.com/es/support)

## Requisitos previos

Antes de empezar, necesitas:

-   Un Mac que ejecute cmux con la sesión iniciada.
-   Un iPhone o iPad con la app cmux BETA instalada desde TestFlight.
-   Una ruta de red desde tu teléfono hasta tu Mac (consulta Usa tu propia red más abajo).

## Usa tu propia red

cmux no proporciona red de fábrica. El flujo de la terminal va directamente entre tu teléfono y tu Mac, así que tu teléfono debe poder alcanzar tu Mac en la red. La forma más sencilla es una red superpuesta privada.

### Tailscale (recomendado)

Instala [Tailscale](https://tailscale.com) en tu Mac y en tu teléfono e inicia sesión en el mismo tailnet. Tu teléfono podrá entonces alcanzar tu Mac por su dirección de tailnet desde cualquier lugar, sin reenvío de puertos.

### WireGuard

Si ya usas [WireGuard](https://www.wireguard.com), pon tu Mac y tu teléfono en la misma red y usa la dirección WireGuard del Mac.

Elijas lo que elijas, la conexión es tuya. cmux no actúa de proxy ni retransmite el tráfico de la terminal entre tus dispositivos.

## Empareja y conecta

1.  En el Mac, abre la ventana Mobile Connect en cmux.
2.  En tu teléfono, abre la app cmux BETA y confirma el emparejamiento que aparece en Mobile Connect.
3.  Una vez emparejados, tus espacios de trabajo y terminales aparecen en el teléfono a través de tu red.

El emparejamiento es por dispositivo. Un dispositivo nuevo, o una app reinstalada, vuelve a emparejarse.

## Notificaciones

Puedes activar el reenvío de las notificaciones de la terminal a tu teléfono, para que un panel que necesita atención envíe un aviso a tu dispositivo. Cuando el reenvío está activado, el texto de la notificación (título y cuerpo, extraído de la salida de la terminal) se envía a través de los servidores de cmux al servicio de notificaciones de Apple para entregarlo. Activa Hide content en los ajustes de notificaciones para enviar un mensaje genérico en su lugar y mantener el texto de la terminal en tus dispositivos. Consulta [notificaciones](https://cmux.com/es/docs/notifications) para ver cómo las genera cmux.

## Qué datos se almacenan

cmux está diseñado para que tu terminal permanezca entre tus dispositivos. En los servidores de cmux solo almacenamos lo necesario para iniciar tu sesión y conectar tus dispositivos:

-   Tu cuenta del inicio de sesión (correo electrónico), para identificarte en todos los dispositivos.
-   Un token de notificaciones para tu dispositivo, para entregar las notificaciones reenviadas de la terminal.
-   Metadatos de emparejamiento y del dispositivo, para conectar tu teléfono con tu Mac.

Tu sesión interactiva de terminal, su contenido y las pulsaciones de teclas fluyen directamente entre tu teléfono y tu Mac a través de tu propia red, y no se retransmiten ni se almacenan en los servidores de cmux. La única excepción es el texto de las notificaciones reenviadas, que transita por cmux y el servicio de notificaciones de Apple para llegar a tu teléfono, a menos que actives Hide content (consulta Notificaciones más arriba).

## Empresas y autoalojamiento

Para un despliegue autoalojado o aislado de red, contacta con [founders@cmux.com](mailto:founders@cmux.com?subject=cmux%20enterprise).

Canonical: https://cmux.com/es/docs/ios

Documentation index: https://cmux.com/llms.txt