Mantenere attive le sessioni

Riconnessione automatica

Quando una connessione cade, l'app riprova e apre una nuova shell. Dopo ogni tentativo aspetta un po' di più, per circa sette minuti. Si ferma se la chiave del server è cambiata o se il server chiede di accedere.

• Attivala o spegnila in Impostazioni, Sessioni: Riconnessione automatica.
• Mentre aspetta, la sessione dice Nuovo tentativo tra 4 s. Ciò che scrivi non viene inviato. Prova ora riprova subito.

Una shell riconnessa è una shell nuova. Per tenere la stessa sessione, vedi sotto.

Mantieni questa sessione

Quando la rete cade, in metropolitana o quando il telefono cambia rete, una sessione mantenuta continua sul server con i programmi che ci girano, anche uno strumento AI. Quando la rete torna, Wardterm si riaggancia da solo alla stessa sessione.

• Apri il menu della sessione: ... su iPhone e iPad, il menu della scheda o Sessione nella barra dei menu sul Mac. Scegli Mantieni questa sessione, poi Continua.
• La sessione passa in tmux sul server, nella stessa scheda. Un programma che gira già resta nella sua shell: se lì gira qualcosa, quella shell resta aperta nella scheda accanto.
• Quando avvii uno strumento AI (Claude Code, Codex, Gemini CLI e altri) in una sessione semplice, Wardterm chiede prima: Avvia così, oppure Avvia e mantieni, che mantiene la sessione e avvia lo strumento lì dentro. Non chiedere più per questo server toglie la domanda su quel dispositivo.
• Il menu di una sessione mantenuta dice che è mantenuta. Per chiuderla, chiudila in Sessioni attive, nel menu del server, o scrivi exit nella sua shell.

Fa parte di tutti i piani. Sul server serve tmux.

Cosa vedi

• Un segno sulla scheda della sessione: Questa sessione continua sul server se cade la connessione.
• Quando la connessione cade: Connessione persa. La sessione continua sul server., poi lo stato della riconnessione
• Quando torna: Di nuovo nella tua sessione. Non si è perso niente.
• Sulla schermata di blocco di iPhone e iPad: Riconnessione… mentre la rete manca, oppure Sessione chiusa sul server.
• Se intanto il comando o lo strumento AI ha finito, arriva il suo avviso. Vedi Avvisi dalle sessioni, parte di Pro.

Un server senza tmux

La sessione resta com'è, e un avviso dice: Per mantenere le sessioni se cade la connessione, questo server ha bisogno di tmux.

• Installa tmux scrive nel terminale il comando di installazione del sistema del server, senza premere Invio. Lo confermi tu, anche con la password di sudo se la chiede.
• Prima che parta uno strumento AI, Installa tmux scrive il comando in una sessione nuova sullo stesso server, e Avvia così avvia lo strumento senza mantenere la sessione.
• Non ora chiude l'avviso.

Quando tmux c'è, la sessione viene mantenuta.

Il tuo tmux

Se la tua shell avvia tmux all'accesso, o lo avvii tu, la sessione la mantiene il tuo tmux. Il menu della sessione dice Il tuo tmux mantiene questa sessione.

Una sessione chiusa altrove

Se mentre sei offline la sessione viene chiusa da un altro dispositivo, o il server si riavvia, la scheda dice La sessione è stata chiusa sul server., con Chiudi e Nuova sessione.

Keepalive

Il keepalive manda un piccolo segnale a intervalli regolari, così una connessione morta viene notata e i router non chiudono una connessione tranquilla.

• Per tutti i server: Impostazioni, Sessioni, Mostra altro: Keepalive, spento o 15, 30, 60 o 120 secondi.
• Per un server o un gruppo: Mostra altro, Connessione, Keepalive.

Lo stesso con OpenSSH, in ~/.ssh/config:

ServerAliveInterval 15

Mosh

Con Mosh, una sessione sopravvive a un cambio di rete e allo stop del dispositivo. Vedi Mosh.

Su iPhone e iPad

Con Tieni aperte le sessioni in background attivo, in Impostazioni, Sessioni, le sessioni aperte restano collegate mentre usi altre app o blocchi lo schermo. È attivo fin dall'inizio. Per chiuderle tutte, togli l'attività in tempo reale dalla schermata di blocco.

Se è spento, il sistema mette in pausa l'app dopo poco e le sue connessioni si chiudono. Con la riconnessione attiva e la sessione mantenuta in tmux, ritrovi il tuo lavoro quando torni. Vedi Le sessioni cadono quando lascio l'app.

Nello stesso punto:

• Mostra su schermata di blocco e Dynamic Island mostra lì le sessioni aperte, con il loro stato.
• Nascondi i nomi dei server mostra Sessione 1, Sessione 2 al loro posto.
• Nella Dynamic Island sceglie cosa mostra quando è piccola: Numero di sessioni o Minima, e con Pro Agenti in attesa. Tieni premuta l'isola per vedere le sessioni.