# 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

### DMG (recomendado)

[Descargar para Mac](https://cmux.com/es/download/confirmation?dl=1)

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 usarla desde otras terminales, abra la paleta de comandos (⌘⇧P) y ejecute **Comando de shell: Instalar 'cmux' en PATH**. Enlaza la CLI incluida en /usr/local/bin y pide una contraseña de administrador si esa carpeta la requiere.

O cree el enlace simbólico usted mismo:

```
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"
```

## Establecer cmux como terminal predeterminada

Para abrir en cmux, en lugar de en Terminal, los enlaces ssh:// y los scripts de shell desde Finder, elija **cmux > Establecer cmux como terminal predeterminada** en la barra de menús o ejecute **Establecer cmux como terminal predeterminada** desde la paleta de comandos.

## 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](https://cmux.com/es/docs/session-restore) for agent hook setup and the supported resume matrix.

## Requisitos

-   macOS 14.0 o posterior
-   Apple Silicon o Intel Mac

Canonical: https://cmux.com/es/docs/getting-started

Documentation index: https://cmux.com/llms.txt
