Curso de iniciación a CMUX: gestiona agentes de IA sin perder el control de tu terminal

Correr tres agentes de IA a la vez y tu terminal ya es un caos: ventanas saltando de un lado a otro, salidas mezcladas, sin saber qué está ejecutando cada una. CMUX existe exactamente para resolver eso. No es otro tmux —es un terminal nativo para macOS diseñado específicamente para escenarios de múltiples agentes de IA, que te permite gestionar varias sesiones a la vez y saber en todo momento qué hace cada panel.

Qué resuelve esta serie

Muchos desarrolladores se encuentran con este problema: las herramientas bastan para uno o dos agentes, pero en cuanto hay más de dos empiezan a interferirse. El concepto de diseño de CMUX consiste en importar la jerarquía «espacio de trabajo → panel → pestaña», de modo que cada agente tenga su propia pista y tú puedas ver el estado global, recibir notificaciones e incluso controlar todo mediante la API de socket.

Esta serie divide CMUX en seis artículos, desde la instalación hasta el uso en producción. No tienes que leerlos de una vez: aprende la estructura y luego salta al que necesites.

A quién va dirigida esta serie

• Personas que ya corren varios agentes de IA (Claude Code, Cursor, opencode) y sienten que el terminal se les escapa de las manos
• Usuarios que vienen de tmux o del Terminal nativo y quieren entender qué diferencia a CMUX
• Quienes quieren automatizar su flujo de trabajo e integrar el CLI de cmux en CI o scripts

Mapa de la serie

La ruta de aprendizaje es la siguiente: primero entender qué problema resuelve CMUX y cómo está estructurado → instalarlo y ponerlo en marcha → comprender los tres niveles (espacio de trabajo, panel, pestaña) → ajustar la apariencia y el comportamiento → crear comandos personalizados para eliminar operaciones repetitivas → y, por último, aplicarlo todo en un escenario real de múltiples agentes.

Qué aprenderás en cada uno de los 6 artículos

1. ¿Qué es CMUX? Por qué lo necesitas en la era de los múltiples agentes
   Introducción: Establece la base conceptual: el posicionamiento de CMUX, sus diferencias con tmux y para quién es adecuado. Sin esto, el resto de la serie no tiene sentido.

2. Instalación de CMUX y configuración del CLI: en marcha en 10 minutos
   Introducción: Instala con DMG o Homebrew, configura el CLI y verifica la instalación. Sin rodeos —síguelo paso a paso y al final tendrá que funcionar.

3. Espacios de trabajo, paneles y pestañas: la estructura de tres capas de CMUX al completo
   Introducción: Este artículo es el esqueleto de toda la serie. Entender las tres capas es fundamental para saber cómo asignar agentes y cambiar de contexto; sin esto, lo que viene después no quedará claro.

4. Guía completa de configuración de CMUX: fuentes, colores, scroll y paneles divididos
   Introducción: Ajusta CMUX a tu gusto, desde el archivo de configuración de Ghostty hasta las opciones de la aplicación.

5. Comandos personalizados: haz que CMUX recuerde tu flujo de trabajo
   Introducción: Usa cmux.json para convertir combinaciones como «lanzar dev server + abrir navegador de preview + tener una shell lista» en un único comando. Un clic y a trabajar.

6. Flujo de trabajo con múltiples agentes en la práctica: patrones reales con CMUX
   Introducción: Conecta todo lo aprendido y aplícalo a un escenario real: correr varios agentes simultáneamente, recibir notificaciones y automatizar con sockets.

Orden de lectura recomendado

Leer en orden 1 → 2 → 3 → 4 → 5 → 6 es la opción más sólida: conceptos → instalación → estructura → configuración → automatización → práctica. Cada artículo se apoya en el anterior.

Si el tiempo escasea: lee el 1 para confirmar si CMUX es para ti, el 2 para instalarlo y el 3 para entender la estructura. Los demás puedes añadirlos según necesidad.

Versión de inicio rápido

En una frase: instala CMUX → crea tres espacios de trabajo y asigna uno a cada agente → usa comandos personalizados para guardar tu combinación de inicio.

Los detalles y el momento oportuno los encontrarás en los seis artículos. La misión de este artículo termina aquí: orientarte, organizarte y empezar.