Se reconnecter automatiquement
Quand une connexion tombe, l'app réessaie et ouvre un nouveau shell. Elle attend un peu plus après chaque essai, pendant environ sept minutes. Elle s'arrête si la clé du serveur a changé ou si le serveur demande un identifiant.
- Activez-la ou désactivez-la dans Réglages, Sessions : Reconnexion automatique.
- Pendant l'attente, la session affiche Nouvel essai dans 4 s. Ce que vous tapez n'est pas envoyé. Essayer réessaie tout de suite.
Un shell reconnecté est un nouveau shell. Pour garder la même session, voir plus bas.
Garder cette session
Quand le réseau tombe, dans le métro ou quand le téléphone change de réseau, une session gardée continue sur le serveur avec les programmes qui y tournent, un outil d'IA compris. Quand le réseau revient, Wardterm se rattache seul à la même session.
- Ouvrez le menu de la session : ... sur iPhone et iPad, le menu de l'onglet ou Session dans la barre des menus sur Mac. Choisissez Garder cette session, puis Continuer.
- La session passe dans tmux sur le serveur, dans le même onglet. Un programme qui tourne déjà reste dans son shell : si quelque chose y tourne, ce shell reste ouvert dans l'onglet à côté.
- Quand vous lancez un outil d'IA (Claude Code, Codex, Gemini CLI et d'autres) dans une session simple, Wardterm demande d'abord : Lancer tel quel, ou Lancer et garder, qui garde la session et y lance l'outil. Ne plus demander pour ce serveur retire la question sur cet appareil.
- Le menu d'une session gardée indique qu'elle est gardée. Pour la terminer, fermez-la dans Sessions actives, dans le menu du serveur, ou tapez exit dans son shell.
Il fait partie de tous les forfaits. Le serveur a besoin de tmux.
Ce que vous voyez
- Une marque sur l'onglet de la session : Cette session continue sur le serveur si la connexion tombe.
- Quand la connexion tombe : Connexion perdue. La session continue sur le serveur., puis l'état de la reconnexion
- Quand elle revient : De retour dans votre session. Rien n'a été perdu.
- Sur l'écran verrouillé, sur iPhone et iPad : Reconnexion… tant que le réseau manque, ou Session fermée sur le serveur.
- Si la commande ou l'outil d'IA a terminé entre-temps, son alerte arrive. Voir Alertes des sessions, incluses dans Pro.
Un serveur sans tmux
La session reste telle quelle, et un avis indique : Pour garder les sessions si la connexion tombe, ce serveur a besoin de tmux.
- Installer tmux écrit dans le terminal la commande d'installation du système du serveur, sans appuyer sur Entrée. Vous la confirmez, avec le mot de passe sudo s'il est demandé.
- Avant le lancement d'un outil d'IA, Installer tmux écrit la commande dans une nouvelle session sur le même serveur, et Lancer tel quel lance l'outil sans garder la session.
- Plus tard ferme l'avis.
Quand tmux est là, la session est gardée.
Votre propre tmux
Si votre shell lance tmux à la connexion, ou si vous le lancez vous-même, votre tmux garde la session. Le menu de la session indique Votre tmux garde cette session.
Une session fermée ailleurs
Si la session est fermée depuis un autre appareil pendant que vous êtes hors ligne, ou si le serveur redémarre, l'onglet affiche La session a été fermée sur le serveur., avec Fermer et Nouvelle session.
Keepalive
Le keepalive envoie un petit signal à intervalles réguliers, pour repérer une connexion morte et pour éviter que les routeurs ferment une connexion silencieuse.
- Pour tous les serveurs : Réglages, Sessions, Afficher plus : Keepalive, désactivé ou 15, 30, 60 ou 120 secondes.
- Pour un serveur ou un groupe : Afficher plus, Connexion, Keepalive.
La même chose avec OpenSSH, dans ~/.ssh/config :
ServerAliveInterval 15Mosh
Avec Mosh, une session survit à un changement de réseau et à la mise en veille de l'appareil. Voir Mosh.
Sur iPhone et iPad
Avec Garder les sessions ouvertes en arrière-plan activé, dans Réglages, Sessions, vos sessions ouvertes restent connectées pendant que vous utilisez d'autres apps ou que l'écran est verrouillé. Il est activé dès le départ. Pour toutes les fermer, retirez l'activité en direct de l'écran verrouillé.
Désactivé, le système met l'app en pause au bout de peu de temps et ses connexions se ferment. Avec la reconnexion activée et la session gardée dans tmux, vous retrouvez votre travail à votre retour. Voir Mes sessions se coupent quand je quitte l'app.
Au même endroit :
- Afficher sur l'écran verrouillé et la Dynamic Island y affiche vos sessions ouvertes, avec leur état.
- Masquer le nom des serveurs affiche Session 1, Session 2 à la place.
- Dans la Dynamic Island choisit ce qu'elle affiche en petit : Nombre de sessions ou Minimal, et avec Pro Agents en attente. Touchez longuement l'île pour voir vos sessions.