Wendov1.0 · iOS et Android
Français

Apprendre

tmux pour agents de code : le minimum pour les garder en marche

· 4 min de lecture

Si tu lances un agent directement depuis un shell SSH, il vit aussi longtemps que cette connexion. Avec tmux, l’agent tourne sur le serveur que tu sois connecté ou non, et tu te rattaches quand tu veux depuis ton portable ou ton téléphone. Pas besoin de connaître tmux à fond : une douzaine de commandes suffisent.

C’est le compagnon de Mosh ou SSH sur ton téléphone, et il s’inscrit dans le guide Comment utiliser Claude Code depuis ton téléphone.

Une session qui survit

La commande que tu utiliseras le plus :

tmux new-session -A -s agents

L’option -A signifie que si une session de ce nom existe, tu t’y rattaches ; sinon elle est créée. Tu peux donc toujours lancer la même chose. À l’intérieur, démarre ton agent comme dans n’importe quel shell :

cd ~/code/my-app
claude

Pour partir sans rien tuer, détache-toi avec Ctrl-b puis d. L’agent continue de tourner. Pour revenir :

tmux attach -t agents

Et pour voir quelles sessions existent :

tmux ls

Si tu fermes le terminal, que le Wi-Fi tombe ou que SSH meurt, peu importe : la session reste sur le serveur. C’est tout l’intérêt.

Fenêtres : un agent par fenêtre

Une session a des fenêtres, comme des onglets. Situation typique : un long refactor tourne dans la fenêtre 2 pendant que les tests tournent dans la 3, et toi tu fouilles quelque chose dans la 1.

Dans tmux, chaque raccourci commence par Ctrl-b :

  • c crée une nouvelle fenêtre.
  • , renomme la fenêtre courante.
  • n et p vont à la fenêtre suivante et précédente.
  • 0–9 sautent à une fenêtre par son numéro.
  • w ouvre une liste où choisir.

Tu peux aussi créer et nommer des fenêtres de l’extérieur, ou depuis un 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

Nommer chaque fenêtre compte plus qu’il n’y paraît. Sur ton téléphone, tu liras « claude », « codex » ou « tests » dans une petite liste, et « bash » quatre fois de suite n’aide pas.

Panes

Si tu veux voir deux choses à la fois dans la même fenêtre, divise-la :

  • Ctrl-b % divise la fenêtre en deux colonnes.
  • Ctrl-b " la divise en deux lignes.
  • Ctrl-b o saute au pane suivant.
  • Ctrl-b x ferme le pane courant (il demande confirmation).

Sur un écran de téléphone, une fenêtre par tâche vaut souvent mieux que des panes. Sur un portable, utilise des panes.

Un petit ~/.tmux.conf

Deux réglages changent beaucoup l’expérience : la prise en charge de la souris et plus d’historique. L’historique par défaut est d’environ 2 000 lignes, et un agent les consomme vite.

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

Avec mouse on, tu peux défiler au doigt ou à la molette et sélectionner des panes en les touchant. allow-rename off empêche le programme en cours de renommer ta fenêtre. Recharge avec :

tmux source-file ~/.tmux.conf

Pour lire ce qui a défilé sans souris, entre en mode copie avec Ctrl-b [ et remonte avec les flèches ou PgUp ; quitte avec q. C’est ce que Mosh ne te donne pas et que tmux te donne.

Plusieurs agents à la fois : worktrees git

Deux agents qui modifient le même répertoire se marchent dessus. La solution propre est un worktree par agent : chacun travaille sur sa propre branche dans son propre dossier, en partageant le même dépôt.

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

Puis une fenêtre tmux pour chacun :

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

Quand une branche est fusionnée et que tu en as fini avec elle :

git worktree remove ../my-app-auth

Comment Wendo s’en sert

Wendo est un client SSH pour iOS et Android conçu pour suivre des agents de code, et tmux en est la pièce centrale. L’intégration de tmux est une fonction de Wendo Pro.

  • À la connexion, ouvrir : choisis tmux et, éventuellement, un nom de session. Wendo exécute tmux new-session -A -s wendo (ou le nom que tu as défini), donc chaque fois que tu ouvres la connexion, tu retombes dans ta session.
  • Machines montre les sessions, fenêtres et panes de chaque ordinateur. Touche-en un et il s’ouvre directement.
  • Avec tmux, la feuille des espaces de travail permet de changer de fenêtre, de renommer, de fermer des panes ou des fenêtres et de créer une session. Tu peux aussi lancer un agent (Claude Code, Codex, OpenCode ou Gemini CLI) dans une nouvelle fenêtre, ou créer un worktree git sur une nouvelle branche et l’ouvrir dans sa propre fenêtre, ce que tu viens de faire à la main plus haut.
  • Les alertes de la boîte de réception t’amènent au pane exact si Claude tourne dans un multiplexeur. L’installation du hook est expliquée dans alertes et approbations.

Les réglages du terminal permettent d’appliquer les options globales de tmux (titres, souris et barre d’état). Tout est dans les docs tmux ; et si ta connexion est instable, les docs des sessions expliquent Mosh et ET.

Alternatives : zellij et herdr

Si tu préfères un autre multiplexeur, Wendo fonctionne aussi avec zellij (zellij attach -c wendo) et herdr (herdr ou herdr --session <name>). Ils doivent être installés sur ton ordinateur. L’idée est la même : l’agent vit sur le serveur et toi tu vas et viens.