La instalación en sí no es complicada, pero si no tienes claros algunos detalles, te quedarás atascado al usar el CLI más adelante. Este artículo recorre el proceso completo, desde la instalación hasta la verificación, y explica por qué es necesario configurar el CLI y cuándo lo necesitarás.

Dos métodos de instalación

Método 1: DMG (recomendado)

Descarga el .dmg desde la web oficial, ábrelo y arrastra CMUX a la carpeta «Aplicaciones». Eso es todo. Las actualizaciones posteriores las gestiona automáticamente Sparkle, el sistema integrado de CMUX, sin que tengas que hacerlo manualmente.

La primera vez que abras la aplicación, macOS puede mostrar una ventana de confirmación preguntando si quieres abrir «una aplicación de un desarrollador identificado». Haz clic en Abrir.

Ventaja de este método: sencillo, actualizaciones automáticas y solo necesitas descargarlo una vez.

Método 2: Homebrew

Si prefieres usar un gestor de paquetes para controlar tus herramientas de forma centralizada:

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

Para actualizaciones posteriores:

brew upgrade --cask cmux

Ambos métodos instalan exactamente lo mismo. Elige el que prefieras.

Verificar que la instalación fue exitosa

Abre CMUX. Deberías ver:

Una barra lateral con pestañas verticales en el lado izquierdo (es el rasgo distintivo de CMUX, no las pestañas horizontales de tmux)
Un espacio de trabajo inicial ya creado
Un terminal listo para recibir comandos

Si ves estos tres elementos, la instalación ha sido exitosa.

Configuración del CLI: por qué es necesaria

CMUX incluye una herramienta CLI llamada cmux que te permite controlar CMUX directamente desde el terminal: listar espacios de trabajo, enviar notificaciones, ejecutar scripts de automatización, todo depende de ella.

Dentro del terminal de CMUX, el CLI está disponible automáticamente, sin configuración adicional.

El problema aparece si ejecutas el comando desde otro terminal (como iTerm2 o el Terminal del sistema): el comando cmux no se encontrará. Para solucionarlo, basta con crear un enlace simbólico:

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

Una vez configurado, cualquier terminal puede invocar cmux:

# Listar todos los espacios de trabajo
cmux list-workspaces
 
# Enviar una notificación
cmux notify --title "Build Complete" --body "Tu build ha terminado"

Esta configuración será muy útil más adelante cuando uses comandos personalizados, integración con CI y scripts de automatización. Se recomienda hacerlo la primera vez que instalas CMUX.

Mecanismo de actualización automática

Los usuarios que instalaron con DMG no tienen que preocuparse por las actualizaciones manuales. CMUX verifica automáticamente si hay actualizaciones nuevas a través de Sparkle y, cuando las hay, verás un aviso en la barra de título. También puedes activarlo manualmente: barra de menús → cmux > Buscar actualizaciones.

Los usuarios de Homebrew actualizan con brew upgrade --cask cmux.

Requisitos del sistema (verificación rápida)

macOS 14.0 (Sonoma) o superior
Compatible con Apple Silicon e Intel Mac

Una vez que tengas CMUX instalado y en funcionamiento, el siguiente paso es entender su estructura de tres capas —eso es lo que realmente marca la diferencia entre «usar CMUX» y «saber usar CMUX»: Espacios de trabajo, paneles y pestañas: la estructura de tres capas de CMUX al completo.