Construire d’abord, figer ensuite 🧊

En pratique, une session tmux se règle rarement du premier coup : des volets (panes) changent de rôle, des fenêtres sont réorganisées, et les commandes évoluent aussi.

tmuxp peut être utile quand la session commence à se stabiliser. Au lieu de tout définir trop tôt dans le YAML, construisez d’abord la session dans tmux, fenêtre par fenêtre et volet par volet. Figez-la ensuite quand elle est stable.

Méthode pratique

1. Démarrer une session tmux

Créez une session tmux, ou rattachez-vous à une session existante. Vous pourrez ensuite vous y reconnecter, l’exporter et la recharger.

$ tmux new-session -As sensors

sensors sert ici d’exemple pour une session de monitoring, mais la même approche fonctionne avec d’autres sessions tmux.

2. Ajuster la session à l’usage

Servez-vous-en et ajustez-la au fur et à mesure : gardez les volets vraiment utiles, redimensionnez pour y voir clair, renommez les fenêtres quand ça aide, puis réaffectez les volets selon le besoin.

3. Exporter la session quand elle est stable

Quand les volets et leurs rôles sont à peu près fixés, exportez la session en cours dans un fichier de configuration tmuxp.

$ tmuxp freeze sensors -o sensors.yaml

4. Nettoyer le YAML si besoin

• Remplacez les commandes reprises à l’export par celles que vous voulez vraiment rejouer, et utilisez des commandes multi-lignes si besoin.
• Pour laisser un volet explicitement vide, utilisez null / blank / pane.
• Préparez les commandes avec enter: false quand elles doivent être visibles sans exécution automatique.
• Placez l’initialisation commune dans shell_command_before (aussi ici).

Gardez les volets et les fenêtres, puis retouchez seulement les commandes à rejouer.

Dans ce sensors.yaml retouché :

• enter: false est appliqué aux volets d’action pour précharger les commandes sans exécution automatique.
• Les deux volets de surveillance, qui exécutent watch, se lancent automatiquement, car ce sont des volets d’observation.
• start_directory: /workspace ouvre le volet dans /workspace, pour retrouver le bon répertoire dès le chargement.
• focus: true place le focus sur ce volet.

5. Charger le YAML

$ tmux has-session -t sensors 2>/dev/null && tmux kill-session -t sensors; tmuxp load ./sensors.yaml

Vérifiez que les volets reviennent comme prévu et que les commandes font bien ce que vous attendez. Sinon, ajustez le YAML puis chargez-le de nouveau.

Travaillez d’abord dans tmux, exportez la session avec tmuxp freeze 🧊, puis ne retouchez le YAML que si besoin.