Una compilación lleva varios minutos en un servidor remoto. La conexión SSH se corta y la ventana del terminal desaparece. ¿Sigue ejecutándose el proceso? La respuesta depende de quién mantiene el terminal y de cuál es el ciclo de vida del proceso, no de si la ventana gráfica sigue abierta.
En una shell ligada directamente a una sesión remota, un cierre de conexión puede afectar al proceso y a su terminal controlador. Con tmux interviene otro programa: un servidor que conserva sesiones, ventanas y panes incluso cuando el cliente visual se desconecta. Ese modelo es la razón para usar tmux; memorizar atajos viene después.
La investigación de referencia utiliza tmux 3.8, lanzado en septiembre de 2026. Sus características nuevas, incluidos los floating panes, no deben extrapolarse a instalaciones antiguas. Aquí se describen operaciones documentadas y ejemplos didácticos; no se atribuyen al autor sesiones de producción ni pruebas remotas ejecutadas.
Arquitectura: el servidor posee las sesiones
Cliente, servidor, sesión, window y pane cumplen funciones distintas. El usuario interactúa con un cliente de tmux desde un emulador. Ese cliente se conecta mediante un socket Unix al servidor tmux, que administra sesiones. Cada sesión contiene ventanas; cada ventana organiza uno o varios panes; cada pane contiene un terminal asociado a un programa como Zsh, Neovim o un proceso de larga duración.
Por ello, cerrar un cliente no equivale a cerrar el servidor. Si la sesión permanece y los procesos siguen vivos, puedes conectar otro cliente a la misma sesión. También es posible observar la misma sesión desde varios clientes, aunque los tamaños y el comportamiento del layout requieren atención. El manual de tmux y el wiki oficial documentan el modelo.
Esta distinción suele confundirse con los buffers y ventanas internas de Neovim. En Neovim, dos ventanas pueden presentar el mismo buffer; en tmux, dos panes suelen contener procesos de terminal independientes. Dividir la pantalla no equivale a compartir estado del editor. En el artículo dedicado a Neovim se trabaja ese modelo desde el punto de vista del editor.
Un ciclo de vida que se puede inspeccionar
El conjunto mínimo de comandos permite comprobar el comportamiento sin plugins:
# Crear una nueva sesión con nombre reconocible.
tmux new-session -s proyecto
# Dentro de tmux: Ctrl-b seguido de d para desconectar el cliente.
# Desde una shell fuera de tmux:
tmux list-sessions
tmux attach-session -t proyecto
# Detener explícitamente una sesión que ya no se necesita:
tmux kill-session -t proyecto
Ctrl-b es el prefijo predeterminado, no una combinación universal que todos los usuarios conservan. Tras el prefijo, d solicita detach: desconecta al cliente y deja al servidor con la sesión. list-sessions muestra el estado observable, mientras que kill-session finaliza la sesión seleccionada y afecta a sus panes y procesos. No ejecutes el último comando en una sesión con tareas que aún deben completarse.
Para organizar trabajo interactivo sin cerrar procesos:
| Acción | Comando de tmux | Efecto |
|---|---|---|
| Crear ventana | new-window -n tests | Otro terminal dentro de la misma sesión |
| Dividir horizontalmente en dos panes | split-window -h | Crea panes lado a lado |
| Dividir verticalmente | split-window -v | Crea panes apilados |
| Ver ventanas y panes | list-windows, list-panes | Inspección de la estructura real |
| Cambiar pane | select-pane -L | Mueve el foco, sin mover el proceso |
Estos subcomandos se ejecutan como tmux <comando> desde la shell o desde la línea de órdenes de tmux con Ctrl-b :. Los significados de horizontal y vertical suelen confundirse con la orientación de la línea divisoria: comprueba qué layout produce cada opción en tu versión instalada. La estructura no es un mero decorado; determina qué programa recibe el teclado y qué salida se conserva en el historial de cada pane.
Detach, desconexión, reboot y restauración no son sinónimos
Hay por lo menos cuatro situaciones diferentes:
- Detach voluntario. El cliente abandona la sesión; el servidor sigue ejecutándose y sus panes no se reinician.
- Pérdida de cliente o SSH. Si el servidor tmux remoto y sus procesos siguen sanos, otra conexión puede volver a adjuntarse. No se garantiza supervivencia frente a todos los errores de host, señales o políticas de administración.
- Terminación del servidor tmux. Se pierde el contenedor de sesiones y los programas asociados pueden terminar. Un nuevo servidor no recupera la memoria ni los PIDs del anterior.
- Reinicio del host. La sesión y los procesos vivos anteriores desaparecen. La reconstrucción requiere mecanismos diferentes de un simple
attach.
tmux-resurrect puede serializar nombres de sesiones, ventanas, panes, directorios y ciertos comandos para una reconstrucción posterior. tmux-continuum automatiza acciones de guardado/restauración según su configuración. Ninguno convierte un proceso anterior en el mismo proceso vivo tras reiniciar una máquina: no preservan PIDs, conexiones abiertas, memoria del programa ni el estado interno de una base de datos. Su soporte de restauración depende además del proceso, del plugin y del entorno.
Un editor con recuperación de swap y un runner de pruebas reiniciado se parecen visualmente a la sesión anterior, pero esa semejanza no prueba continuidad del proceso. Para tareas críticas, el mecanismo correcto puede ser un servicio supervisado por systemd, un job de cola, o un proceso diseñado para checkpoint/retry, con logs persistentes y gestión de errores. tmux sirve para interacción humana persistente, no reemplaza un supervisor de servicios.
SSH: dónde se ejecuta tmux importa
Si ejecutas tmux antes de abrir SSH, la sesión de tmux vive en tu máquina local y su pane contiene un cliente SSH. Al perder la conexión remota, ese pane no mantiene mágicamente los procesos del servidor. Si abres SSH primero y creas tmux en el host remoto, es el servidor tmux remoto el que puede mantener la sesión tras la desconexión.
Un patrón habitual para reconectar a un host ya configurado es:
# Ejemplo ilustrativo. Requiere tmux instalado en el servidor remoto.
ssh -t usuario@servidor.example 'tmux new-session -A -s proyecto'
new-session -A adjunta una sesión existente con ese nombre cuando la encuentra; de lo contrario crea una nueva. -t solicita asignación de PTY para interacción remota. El dominio y el usuario son ficticios; el ejemplo no prueba conectividad ni autoriza a ejecutar trabajos sensibles en un host no administrado.
No conviene usar esta receta sin considerar políticas de acceso: una sesión persistente puede contener variables, historial o resultados sensibles. Protege el acceso SSH, permisos de usuario y el socket de tmux. Si varias personas necesitan colaboración, diseña explícitamente cómo comparten permisos y qué datos pueden observar; no conviertas un socket accesible a todo el sistema en una comodidad por defecto.
Tres capas de compatibilidad: emulador, tmux y aplicación
Hay problemas que no son de tmux ni de Neovim por separado, sino del camino completo de capacidades.
TERM y terminfo
El valor de TERM describe la interfaz que una aplicación debe usar, no una preferencia estética. Fuera de tmux, un emulador puede declarar xterm-256color, foot o algún valor equivalente. Dentro de tmux, es normal exponer tmux-256color si la base terminfo correspondiente existe en el sistema que ejecuta las aplicaciones.
printf 'TERM=%s\n' "$TERM"
infocmp "$TERM" >/dev/null && printf 'Terminfo disponible\n'
tmux -V
Si una máquina remota no conoce tmux-256color, las herramientas pueden perder capacidades o mostrar errores. No lo soluciones asignando valores arbitrarios a TERM: comprueba primero la base terminfo en la máquina donde se ejecuta el programa, el valor real anunciado y los ajustes de tmux. Los nombres de terminal sirven como contratos entre capas.
Color RGB
Una aplicación puede generar secuencias de color RGB y, aun así, ver colores degradados si tmux no conoce o no transmite la capacidad del emulador. Las opciones terminal-features y terminal-overrides se utilizan para describir capacidades, pero una configuración copiada que afirme RGB universal puede fallar al cambiar de terminal, SSH o versión de tmux. Usa la FAQ del wiki para validar el caso concreto en vez de dar por sentado que COLORTERM=truecolor resuelve toda la cadena.
Clipboard y OSC 52
En terminales sin acceso directo a un portapapeles gráfico, OSC 52 permite solicitar al emulador que copie texto. tmux tiene políticas como set-clipboard y necesita que la terminal soporte e interprete esas secuencias. La opción de permitir a aplicaciones ajustar el clipboard también puede tener implicaciones de seguridad: una aplicación remota no confiable podría intentar escribir en él. Decide la política según la frontera de confianza y prueba con el emulador real.
La documentación oficial sobre clipboard explica los detalles de Ms, OSC 52 y compatibilidades. Una sesión que se ve correctamente en SSH no implica que copiar al portapapeles del ordenador local vaya a funcionar de inmediato.
Imágenes y TUIs
Yazi y otras aplicaciones TUI pueden usar protocolos de imagen específicos, entre ellos Sixel y Kitty graphics. El emulador y tmux deben reconocer y transmitir la forma concreta de datos; incluso con soporte de passthrough, las compilaciones y versiones pueden limitar la funcionalidad. No debe asumirse que una preview que funciona fuera de tmux funciona idéntica dentro. La documentación de previews de Yazi es un buen punto de verificación.
Entorno heredado y agentes SSH
Cuando se inicia tmux, el servidor conserva un entorno que puede diferir del entorno de shells posteriores. Al conectar una sesión nueva, variables como SSH_AUTH_SOCK pueden apuntar a un socket antiguo o no deseado. tmux ofrece mecanismos de actualización de entorno para determinadas variables; el efecto preciso depende de la configuración y del momento de attach. No es aconsejable pegar valores de agentes o credenciales en el archivo de configuración para «arreglar» una sesión.
Un diagnóstico mínimo compara el valor de la variable en una shell recién conectada y en un pane existente, revisa el estado de tmux show-environment y decide qué variables necesita realmente el flujo. No olvides que editar un archivo de configuración no cambia necesariamente todos los procesos que ya están ejecutándose.
¿Cuándo es la herramienta adecuada?
- Para desarrollo remoto interactivo: conservar una sesión y volver a adjuntarse tras desconectar el cliente.
- Para organizar tareas locales: editor, tests y logs en terminales independientes, con un servidor que mantiene sus panes.
- Para automatización crítica: no como única garantía de ejecución; conviene un supervisor o sistema de tareas con registro persistente y recuperación específica.
La ventaja de tmux no reside en conservar cualquier estado del mundo. Reside en hacer explícito el límite entre cliente visual y procesos que siguen viviendo en un servidor tmux. Aprender ese límite evita promesas de «recuperación total» que ningún multiplexor puede cumplir por sí solo.
Este modelo se complementa con los artículos del bloque sobre Neovim —la edición y los protocolos— y sobre terminales, Zsh, fzf, Atuin y Yazi —la cadena de capacidades y herramientas. Sus enlaces cruzados se incorporarán cuando las entradas pasen a la colección publicable.
Referencias principales
- tmux: release 3.8 y manual.
- Wiki oficial, FAQ y clipboard.
tmux-resurrectytmux-continuum: límites de recuperación y automatización.- Yazi: protocolos de vista previa.