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

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 utiliser le CLI en dehors de cmux, créez un lien symbolique :

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"

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 :

Disposition des fenêtres, espaces de travail et panneaux
Répertoires de travail
Historique du terminal (au mieux)
URL du navigateur et historique de navigation

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.

Configuration requise

macOS 14.0 ou ultérieur
Mac Apple Silicon ou Intel