cmuxcmux/docs

#Primeros pasos

cmux es una terminal nativa y ligera de macOS basada en Ghostty para gestionar múltiples agentes de programación con IA. Cuenta con pestañas verticales, un panel de notificaciones y una API de control basada en socket.

#Instalación

Descargar para Mac

Abra el .dmg y arrastre cmux a su carpeta de Aplicaciones. cmux se actualiza automáticamente vía Sparkle, por lo que solo necesita descargarlo una vez.

#Homebrew

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

Para actualizar después:

brew upgrade --cask cmux
En el primer inicio, macOS puede pedirle que confirme la apertura de una app de un desarrollador identificado. Haga clic en Abrir para continuar.

#Verificar la instalación

Abra cmux y debería ver:

  • Una ventana de terminal con una barra lateral de pestañas verticales a la izquierda
  • Un workspace inicial ya abierto
  • La terminal con Ghostty lista para recibir entrada

#Configuración de CLI

cmux incluye una herramienta de línea de comandos para automatización. Dentro de las terminales de cmux funciona automáticamente. Para usar la CLI fuera de cmux, cree un enlace simbólico:

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

Luego puede ejecutar comandos como:

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

#Actualizaciones automáticas

cmux busca actualizaciones automáticamente vía Sparkle. Cuando hay una actualización disponible, verá una indicación de actualización en la barra de título. También puede verificar manualmente a través de cmux > Buscar actualizaciones en la barra de menú.

#Restauración de sesión (comportamiento actual)

Después de reiniciar, cmux restaura solo el diseño y los metadatos:

cmux aún no restaura el estado de procesos en ejecución. Las sesiones activas de aplicaciones de terminal como Claude Code, tmux y vim no se reanudan después del reinicio de la app.

See the session restore guide for agent hook setup and the supported resume matrix.

#Requisitos

  • macOS 14.0 o posterior
  • Apple Silicon o Intel Mac