Documentación de Wardterm

Mantener activas las sesiones

Mantén activas las sesiones SSH en Wardterm: con tmux la sesión sigue en el servidor si se cae la conexión, además de reconexión, keepalive y Mosh.

Reconectar automáticamente

Cuando una conexión se cae, la app lo vuelve a intentar y abre un shell nuevo. Espera un poco más después de cada intento, durante unos siete minutos. Se detiene si la clave del servidor ha cambiado o si el servidor necesita un acceso.

  • Actívalo o desactívalo en Ajustes, Sesiones: Reconexión automática.
  • Mientras espera, la sesión dice Nuevo intento en 4 s. Lo que escribes no se envía. Probar ahora lo intenta al momento.

Un shell reconectado es un shell nuevo. Para conservar la misma sesión, mira más abajo.

Mantener esta sesión

Cuando se cae la red, en el metro o cuando el teléfono cambia de red, una sesión mantenida sigue en el servidor con los programas que corren en ella, también una herramienta de IA. Cuando vuelve la red, Wardterm se conecta solo a la misma sesión.

  • Abre el menú de la sesión: ... en iPhone y iPad, el menú de la pestaña o Sesión en la barra de menús en Mac. Elige Mantener esta sesión y después Continuar.
  • La sesión pasa a tmux en el servidor, en la misma pestaña. Un programa que ya se ejecuta se queda en su shell: si algo se ejecuta ahí, ese shell sigue abierto en la pestaña de al lado.
  • Cuando inicias una herramienta de IA (Claude Code, Codex, Gemini CLI y otras) en una sesión simple, Wardterm pregunta primero: Iniciar así, o Iniciar y mantener, que mantiene la sesión e inicia la herramienta en ella. No volver a preguntar para este servidor quita la pregunta en ese dispositivo.
  • El menú de una sesión mantenida indica que se mantiene. Para cerrarla, ciérrala en Sesiones activas, en el menú del servidor, o escribe exit en su shell.

Forma parte de todos los planes. El servidor necesita tmux.

Lo que ves

  • Una marca en la pestaña de la sesión: Esta sesión sigue en el servidor si se cae la conexión.
  • Cuando se cae la conexión: Conexión perdida. La sesión sigue en el servidor., y después el estado de la reconexión
  • Cuando vuelve: De vuelta en tu sesión. No se perdió nada.
  • En la pantalla bloqueada, en iPhone y iPad: Reconectando… mientras falta la red, o Sesión cerrada en el servidor.
  • Si el comando o la herramienta de IA terminó mientras tanto, llega su aviso. Consulta Avisos de las sesiones, parte de Pro.

Un servidor sin tmux

La sesión se queda como está, y un aviso dice: Para mantener las sesiones si se cae la conexión, este servidor necesita tmux.

  • Instalar tmux escribe en el terminal el comando de instalación del sistema del servidor, sin pulsar Intro. Lo confirmas tú, con la contraseña de sudo si la pide.
  • Antes de que se inicie una herramienta de IA, Instalar tmux escribe el comando en una sesión nueva en el mismo servidor, e Iniciar así inicia la herramienta sin mantener la sesión.
  • Ahora no cierra el aviso.

Cuando tmux está, la sesión se mantiene.

Tu propio tmux

Si tu shell inicia tmux al entrar, o lo inicias tú, tu tmux mantiene la sesión. El menú de la sesión dice Tu tmux mantiene esta sesión.

Una sesión cerrada en otro sitio

Si la sesión se cierra desde otro dispositivo mientras estás sin conexión, o el servidor se reinicia, la pestaña dice La sesión se cerró en el servidor., con Cerrar y Nueva sesión.

Keepalive

Keepalive envía una pequeña señal a intervalos regulares, para que se note cuando una conexión ha muerto y para que los routers no cierren una conexión inactiva.

  • Para todos los servidores: Ajustes, Sesiones, Mostrar más: Keepalive, desactivado o 15, 30, 60 o 120 segundos.
  • Para un servidor o un grupo: Mostrar más, Conexión, Keepalive.

Lo mismo con OpenSSH, en ~/.ssh/config:

ServerAliveInterval 15

Mosh

Con Mosh, una sesión sobrevive a un cambio de red y al reposo del dispositivo. Consulta Mosh.

En iPhone y iPad

Con Mantener las sesiones abiertas en segundo plano activado, en Ajustes, Sesiones, tus sesiones abiertas siguen conectadas mientras usas otras apps o bloqueas la pantalla. Está activado desde el principio. Para cerrarlas todas, quita la actividad en vivo de la pantalla bloqueada.

Desactivado, el sistema pone la app en pausa al poco tiempo y sus conexiones se cierran. Con la reconexión activada y la sesión mantenida en tmux, vuelves a encontrar tu trabajo al regresar. Consulta Las sesiones se cortan al salir de la app.

En el mismo sitio:

  • Mostrar en pantalla bloqueada y Dynamic Island muestra ahí tus sesiones abiertas, con su estado.
  • Ocultar nombres de servidores muestra Sesión 1, Sesión 2 en su lugar.
  • En la Dynamic Island elige lo que muestra en pequeño: Número de sesiones o Mínima, y con Pro Agentes en espera. Mantén pulsada la isla para ver tus sesiones.