Commandes et raccourcis essentiels de cmux. Voir aussi les avis sur cmux.

Installation

brew tap manaflow-ai/cmux
brew install --cask cmux
 
# Lier manuellement la CLI si nécessaire
sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux
 
cmux list-workspaces

Prérequis : macOS 14 ou version ultérieure. La TUI distincte couvre aussi Linux et Windows.

Notifications

cmux notify --title "Tests" --body "La suite est terminée"
cmux notify --title "Agent" --subtitle "fix-login" --body "Validation requise"
cmux list-notifications
cmux list-notifications --json
cmux clear-notifications
RaccourciAction
⌘⇧IOuvrir le panneau de notifications.
⌘⇧UAller à la notification non lue la plus récente.

Métadonnées dans la barre latérale

# Afficher un état nommé et sa priorité
cmux set-status build "compilation" --icon hammer --color "#ff9500" --priority 80
 
# Lire l'état d'un workspace
cmux sidebar-state --workspace workspace:2

Utiliser une clé stable comme build, tests, deploy ou review pour que chaque script mette à jour son propre badge.

Automatisation de base

La CLI permet notamment :

list-workspaces   new-workspace   new-split
send              send-key        read-screen
open-url          tree            layout
notify            set-status      sidebar-state

Toujours consulter cmux <commande> --help : l’API évolue rapidement.

Configuration

  • Globale : ~/.config/cmux/cmux.json
  • Projet : .cmux/cmux.json
  • Terminal : reprend thèmes, polices et couleurs de ~/.config/ghostty/config
  • Hooks de notifications : configurables dans notifications.hooks

Organisation recommandée

WorkspacePanes conseillés
FonctionnalitéAgent principal · tests/watch · navigateur.
RevueAgent reviewer · diff/terminal · CI.
IncidentAgent diagnostic · logs · navigateur/monitoring.

cmux ne crée pas automatiquement les worktrees. Pour des modifications parallèles du même dépôt :

git worktree add ../mon-app-fix -b fix/login
git worktree add ../mon-app-feature -b feature/search

Ouvrir ensuite un workspace cmux dans chaque dossier.

Garde-fous

  • Une branche et un worktree par changement livrable.
  • Un port et, si nécessaire, une base distincte par workspace.
  • Ne pas confondre notification « terminée » et changement validé.
  • Faire relire le diff avant commit, puis exécuter les tests hors du contexte de l’agent auteur.
  • Conserver tmux pour les processus distants persistants si nécessaire.

Sources