Wendov1.0 · iOS e Android
Italiano

Guide

tmux per agenti di codice: il minimo per tenerli in esecuzione

· 4 min di lettura

Se avvii un agente direttamente da una shell SSH, vive finché dura quella connessione. Con tmux, l’agente gira sul server che tu sia connesso o no, e ti riattacchi quando vuoi dal portatile o dal telefono. Non serve conoscere tmux a fondo: bastano una dozzina di comandi.

È il compagno di Mosh o SSH sul telefono, e rientra nella guida Come usare Claude Code dal telefono.

Una sessione che sopravvive

Il comando che userai di più:

tmux new-session -A -s agents

L’opzione -A significa che se esiste una sessione con quel nome ti ci attacchi; altrimenti viene creata. Così puoi lanciare sempre lo stesso comando. Dentro, avvia il tuo agente come in qualsiasi shell:

cd ~/code/my-app
claude

Per uscire senza uccidere nulla, stacca con Ctrl-b e poi d. L’agente continua a girare. Per rientrare:

tmux attach -t agents

E per vedere quali sessioni esistono:

tmux ls

Se chiudi il terminale, cade il Wi-Fi o muore SSH, non importa: la sessione resta sul server. È tutto il punto.

Finestre: un agente per finestra

Una sessione ha delle finestre, come schede. La situazione tipica: un lungo refactoring in corso nella finestra 2 mentre i test girano nella 3, e tu che smanetti su qualcosa nella 1.

Dentro tmux, ogni scorciatoia inizia con Ctrl-b:

  • c crea una nuova finestra.
  • , rinomina la finestra corrente.
  • n e p vanno alla finestra successiva e precedente.
  • 0–9 saltano a una finestra per numero.
  • w apre un elenco da cui scegliere.

Puoi anche creare e nominare finestre da fuori, o da uno script:

tmux new-window -n claude -c ~/code/my-app
tmux new-window -n codex -c ~/code/my-app
tmux rename-window -t agents:2 refactor

Dare un nome a ogni finestra conta più di quanto sembri. Sul telefono leggerai «claude», «codex» o «tests» in un elenco piccolo, e «bash» quattro volte di fila non aiuta.

Pane

Se vuoi vedere due cose insieme nella stessa finestra, dividila:

  • Ctrl-b % divide la finestra in due colonne.
  • Ctrl-b " la divide in due righe.
  • Ctrl-b o salta al pane successivo.
  • Ctrl-b x chiude il pane corrente (prima chiede conferma).

Sullo schermo di un telefono, una finestra per compito di solito batte i pane. Sul portatile, usa i pane.

Un piccolo ~/.tmux.conf

Due impostazioni cambiano molto l’esperienza: il supporto del mouse e più cronologia. La cronologia predefinita è di circa 2.000 righe, e un agente le consuma in fretta.

set -g mouse on
set -g history-limit 50000
set -g allow-rename off

Con mouse on puoi scorrere con il dito o con la rotellina e selezionare i pane toccandoli. allow-rename off impedisce al programma in esecuzione di rinominare la tua finestra. Ricaricala con:

tmux source-file ~/.tmux.conf

Per leggere ciò che è scorso via senza mouse, entra in modalità copia con Ctrl-b [ e sali con le frecce o PgUp; esci con q. È ciò che Mosh non ti dà e tmux sì.

Più agenti insieme: worktree git

Due agenti che modificano la stessa directory si pestano i piedi. La soluzione pulita è un worktree per agente: ognuno lavora sul proprio ramo nella propria cartella, condividendo lo stesso repository.

cd ~/code/my-app
git worktree add ../my-app-auth -b feature/auth
git worktree add ../my-app-reports -b feature/reports
git worktree list

Poi una finestra tmux per ciascuno:

tmux new-window -n auth -c ~/code/my-app-auth
tmux new-window -n reports -c ~/code/my-app-reports

Quando un ramo è stato unito e hai finito con lui:

git worktree remove ../my-app-auth

Come lo usa Wendo

Wendo è un client SSH per iOS e Android pensato per seguire gli agenti di codice, e tmux ne è il pezzo centrale. L’integrazione con tmux è una funzione di Wendo Pro.

  • Alla connessione, apri: scegli tmux e, volendo, un nome di sessione. Wendo esegue tmux new-session -A -s wendo (o il nome che hai impostato), così ogni volta che apri la connessione ritrovi la tua sessione.
  • Macchine mostra le sessioni, le finestre e i pane di ogni computer. Tocca una voce e si apre subito.
  • Con tmux, la schermata dei workspace permette di cambiare finestra, rinominare, chiudere pane o finestre e creare una sessione. Puoi anche avviare un agente (Claude Code, Codex, OpenCode o Gemini CLI) in una nuova finestra, oppure creare un worktree git su un nuovo ramo e aprirlo nella sua finestra, cioè quello che hai appena fatto a mano qui sopra.
  • Gli avvisi della posta in arrivo ti portano al pane esatto se Claude gira dentro un multiplexer. L’installazione dell’hook è spiegata in avvisi e approvazioni.

Le impostazioni del terminale includono l’applicazione delle opzioni globali di tmux (titoli, mouse e barra di stato). Tutto è nella documentazione di tmux; e se la connessione è instabile, la documentazione delle sessioni spiega Mosh ed ET.

Alternative: zellij e herdr

Se preferisci un altro multiplexer, Wendo funziona anche con zellij (zellij attach -c wendo) e herdr (herdr o herdr --session <name>). Devono essere installati sul tuo computer. L’idea è la stessa: l’agente vive sul server e tu vai e vieni.