cmux : ce que le dépôt permet réellement

Contexte du projet et motivation déclarée

cmux est un terminal macOS basé sur Ghostty, conçu pour l'utilisation d'agents de codage IA. La section motivation du README décrit l'expérience de l'auteur exécutant plusieurs sessions Claude Code et Codex en parallèle, trouvant les volets divisés de Ghostty et les notifications natives de macOS insuffisants, car les notifications manquaient de contexte et les titres devenaient illisibles avec de nombreux onglets ouverts. En réponse, cmux a été construit comme une application macOS native en Swift et AppKit, utilisant libghostty pour le rendu du terminal. Le README indique explicitement que cmux n'est pas un fork de Ghostty, mais une application différente construite sur son moteur de rendu.

Pour examiner cmux dans son contexte réel, partez du dépôt manaflow-ai/cmux et de son README. La branche main et la version publiée la plus récente indiquée par le matériau sont les repères documentaires disponibles. Les performances, la couverture des cas limites et la sécurité ne sont pas déduites des étoiles ou des forks : elles demandent une observation propre à cmux, avec ses commandes, ses fichiers et ses sorties.

Fonctionnalités principales : barre latérale, notifications et navigateur

Les principales ajouts que cmux décrit sont sa barre latérale et son système de notifications. La barre latérale contient des onglets verticaux affichant la branche git, le statut ou le numéro de la PR liée, le répertoire de travail, les ports en écoute et le texte de la dernière notification pour chaque espace de travail. Le système de notifications détecte les séquences d'échappement du terminal (OSC 9/99/777) et fournit une commande CLI (cmux notify) pour l'intégration dans les hooks d'agents. Lorsqu'un agent attend une entrée, son volet obtient un anneau bleu et son onglet s'allume dans la barre latérale. Le README décrit également un navigateur intégré avec une API scriptable portée depuis agent-browser, permettant aux agents de capturer l'arbre d'accessibilité, d'obtenir des références d'éléments, de cliquer, de remplir des formulaires et d'évaluer du JavaScript.

Installation et canaux de distribution

Le README recommande d'installer cmux via un fichier DMG et indique qu'il se met à jour automatiquement via Sparkle. Il fournit également des commandes d'installation Homebrew : brew tap manaflow-ai/cmux et brew install --cask cmux. Au premier lancement, macOS peut demander à l'utilisateur de confirmer l'ouverture d'une application provenant d'un développeur identifié. De plus, le README mentionne une build nocturne distincte appelée cmux NIGHTLY, qui possède son propre identifiant de bundle, fonctionne aux côtés de la version stable et est construite automatiquement à partir du dernier commit de la branche main.

Programmabilité et interfaces d'automatisation

cmux met l'accent sur sa programmabilité. Il offre une CLI et une API socket pour créer des espaces de travail, diviser des volets, envoyer des frappes clavier, ouvrir des URL dans le navigateur et automatiser le navigateur lui-même. Le README documente également des commandes pour installer des hooks d'agents, comme cmux hooks setup, utilisés pour la reprise de session. Les capacités décrites incluent la lecture du contenu de l'écran, la prise de captures d'écran et le pilotage du navigateur intégré via la même API socket. Les détails d'implémentation spécifiques et les limites de ces interfaces sont indiqués dans la documentation officielle sur cmux.com/docs.

Comportement de restauration de session

cmux enregistre la session en cours à la fermeture et restaure la disposition des fenêtres, des espaces de travail et des volets, les répertoires de travail, le défilement du terminal (au mieux) ainsi que l'URL du navigateur et l'historique de navigation au redémarrage. Il ne vérifie explicitement pas l'état arbitraire des processus en direct, donc tmux, vim, les shells et les applications de terminal non prises en charge se rouvrent comme des terminaux normaux. Les sessions d'agents pris en charge peuvent reprendre si des hooks ont enregistré un identifiant de session natif. Les utilisateurs avancés peuvent attacher une commande de reprise personnalisée à la surface de terminal actuelle en utilisant des commandes comme cmux surface resume set, utile pour les outils avec leur propre état persistant comme les sessions tmux.

Support de plateforme et licence

Selon le README, cmux est exclusivement pour macOS et est une application native Swift et AppKit. Une application iOS est mentionnée comme étant en version bêta, mais la plateforme principale est macOS. Concernant la licence, le README et l'extrait de licence indiquent que cmux est open source sous GPL-3.0-or-later. L'extrait de licence explique en outre que d'autres contributeurs et tiers conservent le droit d'auteur sur leur matériel, et que Manaflow peut proposer des conditions commerciales uniquement pour le matériel pour lequel elle contrôle les droits nécessaires. Le texte de la licence indique qu'il n'y a pas de garantie, et le README ne fournit aucune garantie supplémentaire de support ou de sécurité au-delà du texte GPL standard.

Informations non établies par le README

Bien que le README mentionne des fonctionnalités comme « Skills » et une « Founder's Edition », il ne fournit pas de documentation détaillée à leur sujet dans le README lui-même, pointant plutôt vers des liens externes. Il liste de nombreux agents et intégrations pris en charge, mais pas les étapes de configuration spécifiques. Le README n'établit pas non plus de benchmarks de performance vérifiables, de chiffres d'utilisation mémoire, de résultats d'audit de sécurité ou d'exigences système détaillées. Ces aspects devraient être vérifiés via la documentation du projet, le code source ou d'autres sources officielles.

Conclusion éditoriale

cmux convient aux lecteurs dont le besoin correspond précisément à la fonction décrite par son README. Il ne faut pas le choisir sur sa popularité seule. Commencez par le dépôt https://github.com/manaflow-ai/cmux, reproduisez l’entrée documentée avec la version nightly, observez la sortie propre à cmux, puis vérifiez les fichiers et options mentionnés avant toute intégration.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes