---
title: Intégration tmux / zellij
description: "`gwm tmux` / `gwm zellij` pour ouvrir un worktree dans une nouvelle fenêtre, un panneau ou un onglet."
---
# Intégration tmux / zellij
À l'intérieur d'une session de multiplexeur déjà en cours, `gwm tmux` et `gwm zellij` lancent une nouvelle fenêtre / un nouveau panneau / un nouvel onglet dont le shell démarre à l'intérieur du worktree correspondant — sans aller-retour manuel de `cd`.
## tmux
```bash
gwm tmux auth # new tmux window inside the matched worktree
gwm tmux auth -p # split the current pane instead
gwm tmux auth --split # ...long form of -p
```
Sous le capot :
- **nouvelle fenêtre** (défaut) : `tmux new-window -n <name> -c <path>`
- **split** (`-p` / `--split`) : `tmux split-window -c <path>` (layout de la fenêtre courante, direction du panneau courant)
L'argument `-n <name>` nomme la nouvelle fenêtre d'après le slug du worktree pour qu'elle ressorte dans la barre de statut.
## zellij
```bash
gwm zellij auth # new zellij tab inside the matched worktree
gwm zellij auth -p # new pane in the current tab instead
```
Sous le capot :
- **nouvel onglet** (défaut) : `zellij action new-tab --name <name> --cwd <path>`
- **nouveau panneau** (`-p` / `--split`) : `zellij action new-pane --cwd <path>`
Le flag `--cwd` sur `new-tab` nécessite **zellij ≥ 0.40** ; les versions plus anciennes échouent. `new-pane --cwd` est stable depuis plus longtemps — utilisez `-p` si vous êtes coincé sur un zellij plus ancien.
## session requise
Les deux commandes nécessitent que le multiplexeur correspondant soit effectivement en cours d'exécution :
- `gwm tmux` vérifie la présence de `$TMUX` dans l'environnement.
- `gwm zellij` vérifie celle de `$ZELLIJ`.
En dehors d'une session, la commande **refuse** avec une erreur claire plutôt que de lancer un serveur orphelin — l'alternative (lancer en détaché) mène à des sessions orphelines que l'utilisateur ne voit jamais.
```bash
$ gwm tmux auth
gwm tmux requires an active tmux session ($TMUX is not set).
```
## correspondance fuzzy
L'argument `<pattern>` utilise le même matcher fuzzy que `gwm path / remove / bootstrap` ([nucleo-matcher](https://docs.rs/nucleo-matcher)). Les correspondances ambiguës sortent `1` et affichent les deux candidats sans rien lancer.
## voir aussi
- [TUI → Filtre fuzzy](/fr/tui/filter) — les règles de sensibilité à la casse et de scoring du matcher
- [CLI → Référence des sous-commandes](/fr/cli/reference#gwm-tmux-pattern--p--split) — flags et codes de sortie