Un terminal macOS basado en Ghostty con pestañas verticales y notificaciones para agentes de programación con IA
English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ | Українська
▶ Video de demostración · The Zen of cmux
## Características
Anillos de notificaciónLos paneles obtienen un anillo azul y las pestañas se iluminan cuando los agentes de programación necesitan tu atención |
|
Panel de notificacionesVe todas las notificaciones pendientes en un solo lugar, salta a la más reciente no leída |
|
Navegador integradoDivide un navegador junto a tu terminal con una API programable portada de agent-browser |
|
Pestañas verticales + horizontalesLa barra lateral muestra la rama de git, el estado/número del PR vinculado, el directorio de trabajo, los puertos en escucha y el texto de la última notificación. Divide horizontal y verticalmente. |
|
SSHcmux ssh user@remote crea un espacio de trabajo para una máquina remota. Los paneles del navegador se enrutan a través de la red remota, así que localhost simplemente funciona. Arrastra una imagen a una sesión remota para subirla vía scp.
|
|
Claude Code Teamscmux claude-teams ejecuta el modo de compañeros de equipo de Claude Code con un solo comando. Los compañeros aparecen como divisiones nativas con metadatos en la barra lateral y notificaciones. No se requiere tmux.
|
|
Abre el `.dmg` y arrastra cmux a tu carpeta de Aplicaciones. cmux se actualiza automáticamente a través de Sparkle, así que solo necesitas descargarlo una vez.
### Homebrew
```bash
brew tap manaflow-ai/cmux
brew install --cask cmux
```
Para actualizar más tarde:
```bash
brew upgrade --cask cmux
```
En el primer inicio, macOS puede pedirte que confirmes la apertura de una app de un desarrollador identificado. Haz clic en **Abrir** para continuar.
## ¿Por qué cmux?
Ejecuto muchas sesiones de Claude Code y Codex en paralelo. Estaba usando Ghostty con un montón de paneles divididos y dependía de las notificaciones nativas de macOS para saber cuándo un agente me necesitaba. Pero el cuerpo de la notificación de Claude Code siempre es solo "Claude is waiting for your input" sin contexto, y con suficientes pestañas abiertas ya ni siquiera podía leer los títulos.
Probé algunos orquestadores de programación, pero la mayoría eran aplicaciones Electron/Tauri y el rendimiento me molestaba. Además, simplemente prefiero la terminal ya que los orquestadores con GUI te encierran en su flujo de trabajo. Así que construí cmux como una app nativa de macOS en Swift/AppKit. Usa libghostty para el renderizado del terminal y lee tu configuración existente de Ghostty para temas, fuentes y colores.
Las principales adiciones son la barra lateral y el sistema de notificaciones. La barra lateral tiene pestañas verticales que muestran la rama de git, el estado/número del PR vinculado, el directorio de trabajo, los puertos en escucha y el texto de la última notificación para cada espacio de trabajo. El sistema de notificaciones detecta secuencias de terminal (OSC 9/99/777) y tiene un CLI (`cmux notify`) que puedes conectar a los hooks de agentes para Claude Code, OpenCode, etc. Cuando un agente está esperando, su panel obtiene un anillo azul y la pestaña se ilumina en la barra lateral, para que pueda saber cuál me necesita entre divisiones y pestañas. Cmd+Shift+U salta a la notificación no leída más reciente.
El navegador integrado tiene una API programable portada de [agent-browser](https://github.com/vercel-labs/agent-browser). Los agentes pueden capturar el árbol de accesibilidad, obtener referencias de elementos, hacer clic, rellenar formularios y ejecutar JS. Puedes dividir un panel de navegador junto a tu terminal y hacer que Claude Code interactúe directamente con tu servidor de desarrollo.
Todo es programable a través del CLI y la API de socket — crear espacios de trabajo/pestañas, dividir paneles, enviar pulsaciones de teclas, abrir URLs en el navegador.
## The Zen of cmux
cmux no prescribe cómo los desarrolladores deben usar sus herramientas. Es un terminal y navegador con un CLI, y el resto depende de ti.
cmux es un primitivo, no una solución. Te da un terminal, un navegador, notificaciones, espacios de trabajo, divisiones, pestañas y un CLI para controlarlo todo. cmux no te obliga a usar los agentes de programación de una manera específica. Lo que construyas con los primitivos es tuyo.
Los mejores desarrolladores siempre han construido sus propias herramientas. Nadie ha descubierto la mejor manera de trabajar con agentes todavía, y los equipos que construyen productos cerrados tampoco. Los desarrolladores más cercanos a sus propias bases de código lo descubrirán primero.
Dale a un millón de desarrolladores primitivos componibles y encontrarán colectivamente los flujos de trabajo más eficientes más rápido de lo que cualquier equipo de producto podría diseñar de arriba hacia abajo.
## Documentación
Para más información sobre cómo configurar cmux, [visita nuestra documentación](https://cmux.com/docs/getting-started?utm_source=readme).
## Atajos de teclado
### Espacios de trabajo
| Atajo | Acción |
|----------|--------|
| ⌘ N | Nuevo espacio de trabajo |
| ⌘ 1–8 | Ir al espacio de trabajo 1–8 |
| ⌘ 9 | Ir al último espacio de trabajo |
| ⌃ ⌘ ] | Siguiente espacio de trabajo |
| ⌃ ⌘ [ | Espacio de trabajo anterior |
| ⌘ ⇧ W | Cerrar espacio de trabajo |
| ⌘ ⇧ R | Renombrar espacio de trabajo |
| ⌥ ⌘ E | Editar descripción del espacio de trabajo |
| ⌘ B | Alternar barra lateral |
| ⌥ ⌘ B | Alternar barra lateral derecha |
| ⌘ ⇧ E | Alternar foco de la barra lateral derecha |
### Superficies
| Atajo | Acción |
|----------|--------|
| ⌘ T | Nueva superficie |
| ⌘ ⇧ ] | Siguiente superficie |
| ⌘ ⇧ [ | Superficie anterior |
| ⌃ Tab | Siguiente superficie |
| ⌃ ⇧ Tab | Superficie anterior |
| ⌃ 1–8 | Ir a la superficie 1–8 |
| ⌃ 9 | Ir a la última superficie |
| ⌘ W | Cerrar superficie |
### Paneles divididos
| Atajo | Acción |
|----------|--------|
| ⌘ D | Dividir a la derecha |
| ⌘ ⇧ D | Dividir hacia abajo |
| ⌥ ⌘ ← → ↑ ↓ | Enfocar panel direccionalmente |
| ⌘ ⇧ H | Destellar panel enfocado |
### Navegador
Los atajos de herramientas de desarrollo del navegador siguen los valores predeterminados de Safari y son personalizables en `Ajustes → Atajos de teclado`.
Los atajos de navegación de la paleta de comandos, incluido ⌃ P, también son personalizables y se pueden borrar para que la pulsación llegue al terminal activo.
| Atajo | Acción |
|----------|--------|
| ⌘ ⇧ L | Abrir navegador en división |
| ⌘ L | Enfocar barra de direcciones |
| ⌘ [ | Atrás |
| ⌘ ] | Adelante |
| ⌘ R | Recargar página |
| ⌥ ⌘ I | Alternar herramientas de desarrollo (predeterminado de Safari) |
| ⌥ ⌘ C | Mostrar consola de JavaScript (predeterminado de Safari) |
### Notificaciones
| Atajo | Acción |
|----------|--------|
| ⌘ I | Mostrar panel de notificaciones |
| ⌘ ⇧ U | Ir a la última no leída |
| ⌥ ⌘ U | Alternar estado no leído del elemento actual |
| ⌃ ⌘ U | Marcar el elemento actual como la no leída más antigua y saltar a la siguiente más reciente no leída |
### Buscar
| Atajo | Acción |
|----------|--------|
| ⌘ F | Buscar |
| ⌘ ⇧ F | Buscar en el directorio |
| ⌘ G / ⌥ ⌘ G | Buscar siguiente / anterior |
| ⌥ ⌘ ⇧ F | Ocultar barra de búsqueda |
| ⌘ E | Usar selección para buscar |
### Terminal
| Atajo | Acción |
|----------|--------|
| ⌘ K | Limpiar historial de desplazamiento |
| ⌘ C | Copiar (con selección) |
| ⌘ V | Pegar |
| ⌘ + / ⌘ - | Aumentar / disminuir tamaño de fuente |
| ⌘ 0 | Restablecer tamaño de fuente |
### Ventana
| Atajo | Acción |
|----------|--------|
| ⌘ ⇧ N | Nueva ventana |
| ⌘ ⇧ O | Reabrir sesión anterior |
| ⌘ , | Ajustes |
| ⌘ ⇧ , | Recargar configuración |
| ⌘ Q | Salir |
## Compilaciones nocturnas
[Descargar cmux NIGHTLY](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos.dmg)
cmux NIGHTLY es una app separada con su propio bundle ID, por lo que se ejecuta junto a la versión estable. Se compila automáticamente desde el último commit de `main` y se actualiza automáticamente a través de su propio feed de Sparkle.
Reporta errores de nightly en [GitHub Issues](https://github.com/manaflow-ai/cmux/issues) o en [#nightly-bugs en Discord](https://discord.gg/xsgFEVrWCZ).
## Restauración de sesión
Al salir, cmux guarda la sesión actual. Al relanzar, cmux restaura el estado
que pertenece a la app:
- Diseño de ventanas/espacios de trabajo/paneles
- Directorios de trabajo
- Historial de desplazamiento del terminal (mejor esfuerzo)
- URL del navegador e historial de navegación
cmux no guarda puntos de control de procesos activos arbitrarios. tmux, vim, shells y
apps de terminal no compatibles se vuelven a abrir como terminales normales.
Las sesiones de agentes compatibles pueden reanudarse cuando los hooks han guardado un ID
de sesión nativo. Instala los hooks después de instalar el CLI del agente para que su
binario esté en el `PATH`:
```bash
cmux hooks setup
cmux hooks setup codex
cmux hooks setup --agent opencode
```
`cmux hooks setup` instala los agentes compatibles que encuentra e imprime un resumen
de los agentes omitidos. Las integraciones de reanudación compatibles incluyen Claude Code, Codex,
Grok, OpenCode, Pi, Amp, Cursor CLI, Gemini, Rovo Dev, Copilot, CodeBuddy,
Factory y Qoder. Claude Code es gestionado por el wrapper de Claude de cmux cuando la
integración de Claude está habilitada en Ajustes.
Los usuarios avanzados y las integraciones pueden asociar un comando de reanudación personalizado a la
superficie de terminal actual. Esto es útil para herramientas con su propio estado duradero,
como sesiones tmux o CLIs de agentes personalizados:
```bash
cmux surface resume set --kind tmux --checkpoint work --shell "tmux attach -t work"
cmux surface resume show --json
cmux surface resume clear --checkpoint work
```
La asociación queda ligada a la superficie de cmux. Las asociaciones creadas por el CLI
público o el socket se guardan para inspección y restauración manual, a menos que apruebes un
prefijo de comando firmado para restauración automática. Los prefijos aprobados también quedan ligados
al directorio de trabajo y a los valores exactos del entorno, cuando están presentes. Revisa o edita
las aprobaciones en **Ajustes > Terminal > Comandos de reanudación**. cmux solo ejecuta automáticamente
las asociaciones de reanudación que marca como confiables, como las asociaciones tmux detectadas en procesos
activos o los prefijos aprobados por el usuario. Las claves de entorno sensibles, como tokens, contraseñas,
secretos y claves de API, se descartan antes de guardar una asociación de reanudación.
Para mantener los terminales de agentes restaurados inactivos en lugar de ejecutar automáticamente sus comandos de reanudación,
desactiva **Ajustes > Terminal > Reanudar sesiones de agentes al reabrir** o establece esto en
`~/.config/cmux/cmux.json`:
```json
{
"terminal": {
"autoResumeAgentSessions": false
}
}
```
Esto solo desactiva los comandos de reanudación automática de agentes. cmux sigue restaurando el diseño guardado,
los directorios de trabajo, el historial de desplazamiento y el historial del navegador.
Si necesitas volver a aplicar manualmente la última instantánea guardada, usa:
- `Archivo > Reabrir sesión anterior`
- `⌘ ⇧ O`
- `cmux restore-session`
Internamente, cmux escribe una instantánea versionada en
`~/Library/Application Support/cmux/` y los hooks de los agentes escriben las asignaciones de sesión
en `~/.cmuxterm/`. Al restaurar, cmux reconstruye primero el diseño y luego ejecuta el
comando de reanudación nativo del agente compatible cuando la reanudación automática de agentes está habilitada.
Lee la guía completa en
WeChat: Escanea el código QR para unirte a la comunidad.
