Guide

tmux y Mosh

Integración del modo ratón de tmux, Mosh para conexiones resilientes, y Live Activities

tmux y Mosh

MTerm se integra profundamente con tmux e implementa el protocolo Mosh nativamente, dándote dos herramientas poderosas para gestionar sesiones remotas. Esta guía cubre cómo funcionan ambas y cómo sacarles el máximo provecho.


Integración con tmux

Si usas tmux en tu servidor remoto, MTerm lo hace sentir como una parte nativa de la app en lugar de una herramienta separada ejecutándose dentro del terminal.

Detección automática del modo ratón

MTerm detecta automáticamente cuando tmux tiene el modo ratón habilitado y traduce tus gestos táctiles en los eventos de ratón apropiados. No necesitas configurar nada en MTerm — solo asegúrate de que tu ~/.tmux.conf incluya:

set -g mouse on

Con esto habilitado, tus interacciones táctiles se mapean directamente a acciones de tmux:

  • Toca un panel de tmux para cambiar el foco a él
  • Desplázate con toque o trackpad para navegar por el historial de tmux

Tres configuraciones de modo ratón

Puedes controlar este comportamiento en la configuración de MTerm:

ModoComportamiento
Auto (por defecto)Envía eventos de ratón solo cuando tmux tiene el modo ratón activo. Cuando el modo ratón está desactivado, el desplazamiento usa el búfer de desplazamiento propio de MTerm.
Always ONSiempre reenvía eventos táctiles a tmux, incluso si el modo ratón no está explícitamente habilitado. Útil si quieres que todas las interacciones de desplazamiento y toque vayan directamente a tmux.
OffNunca envía eventos de ratón a tmux. Todo el desplazamiento usa el búfer local de MTerm.

Detección automática de pantalla alternativa

MTerm detecta cuando el terminal entra en modo de pantalla alternativa (usado por aplicaciones como Vim, less, htop y el propio tmux). Esto afecta el comportamiento de desplazamiento — cuando la pantalla alternativa está activa, el desplazamiento se reenvía a la aplicación en ejecución en lugar de desplazar el búfer local de MTerm.

Gestión de sesiones y ventanas de tmux

Como MTerm maneja los eventos de ratón de tmux nativamente, puedes:

  • Tocar las pestañas de ventana de tmux en la barra de estado para cambiar ventanas
  • Tocar paneles de tmux para cambiar el foco
  • Desplazarte dentro de paneles de tmux individuales
  • Usar el redimensionamiento de paneles de tmux basado en ratón arrastrando los bordes

Manejador OSC 1212

MTerm implementa el manejador de secuencia de escape OSC 1212 para compartir contexto y notificaciones entre tmux y la app. Esto permite escenarios de integración avanzados donde tmux puede comunicar cambios de estado a MTerm.


Conexión Mosh

Mosh (Mobile Shell) resuelve una de las mayores frustraciones de usar SSH desde un dispositivo móvil: las conexiones caídas. El SSH estándar sobre TCP muere en el momento en que tu red cambia — al cambiar de Wi-Fi a datos móviles, al moverse entre puntos de acceso, o ante una breve interrupción de red. Mosh maneja todo esto con elegancia.

Cómo funciona Mosh

A diferencia de SSH, que usa una conexión TCP persistente, Mosh usa UDP. Esto significa:

  • Los cambios de red son invisibles. Cambia de Wi-Fi a datos móviles y viceversa. Tu sesión nunca se cae.
  • Las interrupciones breves se manejan automáticamente. Si pierdes conectividad por unos segundos (o incluso minutos), Mosh se reconecta sin perder ningún estado.
  • Menor latencia. Mosh predice tus pulsaciones de tecla localmente y las muestra inmediatamente, corrigiendo después si la predicción fue incorrecta. Esto hace que escribir se sienta responsivo incluso en conexiones de alta latencia.
  • Sin sesiones colgadas. Las conexiones TCP pueden quedar colgadas por minutos antes de expirar. Las conexiones Mosh funcionan o inmediatamente te dicen que están desconectadas.

Configurar Mosh

  1. Instala mosh-server en tu host remoto:

    # Ubuntu/Debian
    sudo apt install mosh
    
    # macOS
    brew install mosh
    
    # CentOS/RHEL
    sudo yum install mosh
  2. En MTerm, edita la configuración del host y cambia el método de conexión de SSH a Mosh.

  3. Conéctate como de costumbre. MTerm establecerá una conexión SSH inicial para iniciar la sesión Mosh, luego cambiará a UDP para la sesión de terminal real.

Cuándo usar Mosh

Mosh es ideal cuando:

  • Trabajas desde ubicaciones con Wi-Fi poco confiable (cafés, aeropuertos, trenes)
  • Cambias frecuentemente de red
  • Usas datos móviles con señal variable
  • Ejecutas sesiones de larga duración que quieres que sobrevivan interrupciones de red

Para conexiones estables en una red confiable, el SSH estándar funciona perfectamente y tiene la ventaja de soportar port forwarding y otras funciones basadas en TCP.

Mosh requiere plan Pro


Live Activities (pantalla de bloqueo y Dynamic Island)

MTerm usa iOS Live Activities para mantenerte informado sobre tus sesiones activas incluso cuando la app está en segundo plano.

Widget en la pantalla de bloqueo

Cuando tienes una sesión SSH o Mosh activa, un widget de Live Activity aparece en tu pantalla de bloqueo mostrando el estado de la conexión. Puedes ver de un vistazo si tu sesión sigue conectada, reconectando o desconectada — sin desbloquear tu dispositivo ni abrir la app.

Dynamic Island

En dispositivos con Dynamic Island (iPhone 14 Pro y posteriores), MTerm muestra un indicador compacto del estado de conexión. Toca la Dynamic Island para volver directamente a tu sesión de terminal.

Por qué esto importa

Si estás ejecutando una tarea larga de Claude Code y cambias a otra app para revisar correos o consultar documentación, Live Activities te permite monitorear la conexión sin cambiar repetidamente de vuelta a MTerm. Combina esto con notificaciones Webhook y puedes salir de la app con confianza sabiendo que serás informado cuando tu tarea se complete o si tu conexión cae.