# Intégration i3

## i3bar

Ajoutez `vmux i3bar` comme `status_command` dans votre `~/.config/i3/config` :

```
bar {
    status_command vmux i3bar
    position top
    ...
}
```

Rechargez i3 (`$mod+Shift+r`). vmux démarre le daemon automatiquement si nécessaire.

### Format des blocs

Un bloc par session active, trié par numéro de workspace :

```
3-vmux[W]   5-api[⚡ 45s]   7-front[? 3m]
```

- `3-vmux` — workspace i3 + nom (label ou dernier composant du cwd)
- `[W]` vert — Working
- `[⚡ 45s]` rouge — Needs Input, type permission, en attente depuis 45s
- `[?]` rouge — Needs Input, type question
- `[!]` rouge — Needs Input, autre type
- `[I]` gris — Idle
- `[?]` gris — état inconnu

Si le daemon est offline : `vmux: offline`.  
Si aucune session détectée : `vmux: no sessions`.

## Commande switch

Basculez vers le workspace d'une session depuis votre terminal :

```sh
vmux switch vmux    # cherche une session dont le cwd ou label contient "vmux"
vmux switch api
```

La correspondance est fuzzy : le premier mot du workspace/label/cwd qui contient la query gagne.

Vous pouvez aussi lier cette commande à un raccourci i3 :

```
bindsym $mod+F1 exec vmux switch feature-1
bindsym $mod+F2 exec vmux switch feature-2
```

## Notifications desktop

vmux envoie une notification `notify-send` quand une session passe de `Working` à `Needs Input`. Assurez-vous qu'un daemon de notification tourne (`dunst`, `mako`, etc.).

### Mode focus

Pour couper les notifications temporairement :

```sh
vmux focus 30    # supprimer 30 minutes
vmux focus 0     # réactiver immédiatement
```

## Dépannage

**Le workspace n'apparaît pas dans `vmux list`**

vmux résout les workspaces via i3 IPC et X11. Vérifiez que `DISPLAY` est défini dans l'environnement du daemon. Si le daemon est lancé depuis un service systemd, il peut ne pas hériter de `DISPLAY`.

**Les hooks ne fonctionnent pas**

1. Vérifiez que `vmux setup` a été lancé et que `~/.claude/settings.json` contient les hooks
2. Redémarrez les sessions Claude Code après `vmux setup`
3. Le hook server écoute sur `localhost:3119` — vérifiez qu'aucun autre processus n'occupe ce port

**`vmux list` ne voit aucune session**

Le daemon scrute `/proc` pour les processus dont la commande contient `claude`. Vérifiez :
```sh
ps aux | grep claude
```
Si aucun processus n'apparaît, Claude Code n'est pas détecté. Vérifiez le nom du binaire sur votre système.