# Premiers pas

cmux est un terminal macOS natif et léger basé sur Ghostty pour gérer plusieurs agents de code IA. Il propose des onglets verticaux, un panneau de notifications et une API de contrôle par socket.

## Installation

### DMG (recommandé)

[Télécharger pour Mac](https://cmux.com/fr/download/confirmation?dl=1)

Ouvrez le .dmg et faites glisser cmux dans votre dossier Applications. cmux se met à jour automatiquement via Sparkle, vous n'avez besoin de télécharger qu'une seule fois.

### Homebrew

```
brew tap manaflow-ai/cmux
brew install --cask cmux
```

Pour mettre à jour plus tard :

```
brew upgrade --cask cmux
```

Au premier lancement, macOS peut vous demander de confirmer l'ouverture d'une application d'un développeur identifié. Cliquez sur **Ouvrir** pour continuer.

## Vérifier l'installation

Ouvrez cmux et vous devriez voir :

-   Une fenêtre terminal avec une barre latérale d'onglets verticaux à gauche
-   Un espace de travail initial déjà ouvert
-   Le terminal Ghostty prêt pour la saisie

## Configuration du CLI

cmux inclut un outil en ligne de commande pour l'automatisation. Dans les terminaux cmux, il fonctionne automatiquement. Pour l'utiliser depuis d'autres terminaux, ouvrez la palette de commandes (⌘⇧P) et lancez **Commande Shell : installer « cmux » dans le PATH**. Le CLI fourni est lié dans /usr/local/bin, et un mot de passe administrateur est demandé si ce dossier l'exige.

Ou créez le lien symbolique vous-même :

```
sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux
```

Ensuite vous pouvez exécuter des commandes comme :

```
cmux list-workspaces
cmux notify --title "Build Complete" --body "Your build finished"
```

## Faire de cmux votre terminal par défaut

Pour ouvrir dans cmux plutôt que dans Terminal les liens ssh:// et les scripts shell lancés depuis le Finder, choisissez **cmux > Définir cmux comme terminal par défaut** dans la barre des menus, ou lancez **Définir cmux comme terminal par défaut** depuis la palette de commandes.

## Mises à jour automatiques

cmux vérifie les mises à jour automatiquement via Sparkle. Quand une mise à jour est disponible, vous verrez une pastille de mise à jour dans la barre de titre. Vous pouvez aussi vérifier manuellement via cmux > Rechercher des mises à jour dans la barre de menus.

## Restauration de session (comportement actuel)

Après un redémarrage, cmux restaure uniquement la disposition et les métadonnées :

cmux ne restaure pas encore l'état des processus en cours. Les sessions d'applications terminales actives comme Claude Code, tmux et vim ne sont pas reprises après un redémarrage de l'application.

See the [session restore guide](https://cmux.com/fr/docs/session-restore) for agent hook setup and the supported resume matrix.

## Configuration requise

-   macOS 14.0 ou ultérieur
-   Mac Apple Silicon ou Intel

Canonical: https://cmux.com/fr/docs/getting-started

Documentation index: https://cmux.com/llms.txt