Primeros pasos

Instale ccmux en la máquina que ejecutará sus agentes. Después de la configuración, cree un proyecto y adjunte a su primera sesión.

Requisitos

macOS, Linux o Windows vía WSL2 (ver el Guía Windows en GitHub: el Windows nativo se rastrea como un TODO abierto)
Uno de: Homebrew (macOS / Linuxbrew), curl + un shell POSIX o Go 1.26+ para la ruta desde el origen
tmux y git. Homebrew instala las dependencias del tiempo de ejecución; el script de descarga instala únicamente los archivos binarios ccmux. correr ccmux setup para verificar dependencias, o usar make bootstrap al compilar desde el código fuente.

Instalar

Elija el script de descarga o Homebrew. Utilice la compilación fuente si desea desarrollar ccmux.

Descargar script

curl -fsSL https://ccmux.ai/install | sh
ccmux setup

El script instala los binarios de la última versión en ~/.local/bin/. Agregue ese directorio al PATH de su shell si el instalador se lo solicita. tu puedes inspeccionar el script de instalación antes de ejecutarlo.

El asistente de configuración verifica las dependencias, ayuda a configurar las CLI de su agente e instala el demonio en segundo plano. Inicie sesión con su agente elegido antes de iniciar una sesión. Para acceso remoto, conecte también sus dispositivos al Tailscale.

Homebrew

brew trust --tap skzv/tap
brew install skzv/tap/ccmux
ccmux setup

Confía en el grifo una vez por máquina. Homebrew instala ccmux y sus dependencias empaquetadas, incluidas tmux, Mosh y ripgrep.

Alternativa: desde la fuente

mkdir -p ~/Projects && cd ~/Projects
git clone https://github.com/skzv/ccmux.git
cd ccmux && make bootstrap

make bootstrap verifica su cadena de compilación y ofrece instalar todo lo que falta, luego lo encadena make setup. Utilice esto si desea realizar un seguimiento main o piratear el propio ccmux.

Puede volver a ejecutar el asistente de configuración más tarde para revisar su configuración.

Primera ejecución

ccmux

El TUI se lanza con un recorrido de estreno. prensa ? en cualquier pantalla para ver el mapa de teclas completo.

Atajos de teclas

Clave	Acción
`1`–`7`	Cambiar de pantalla (Sesiones, Proyectos, Conversaciones, Notas, Agentes, Configuración, Red)
`Enter`	Adjuntar a la sesión seleccionada
`?`	Ayuda contextual
`T`	Repetir el recorrido de la primera ejecución
`j` / `k` o `↑` / `↓`	Navegar por listas
`x`	Cerrar sesión seleccionada

Tu primer proyecto

En el TUI: presione 2 para Proyectos, luego n para abrir el formulario de nuevo proyecto. Complete el nombre, elija un agente (Claude / Codex / Antigravity / Cursor / pi / Grok) y presione Enter. ccmux crea el directorio en projects.root e inicia la sesión del agente inmediatamente.

Desde el shell:

ccmux new my-app

Crea el directorio e inicia la sesión con su agente predeterminado. El TUI se abre automáticamente en la pantalla de inicio donde puede conectarlo con Enter.

Ver Tutorial 1 para obtener un tutorial completo.

Próximos pasos

Administrar múltiples sesiones y desconectarse sin detener a un agente.
Conéctate desde tu teléfono o agregar otra máquina.
Conectar un cliente MCP para inspeccionar sesiones de su agente.
Si la configuración falla, ejecute ccmux doctor y sigue las guía de mantenimiento.

Ayuda a mejorar ccmux

¿Encontraste un error, una guía poco clara o una traducción mejorable? Todas las aportaciones son bienvenidas. Abre una incidencia o envía una solicitud de incorporación de cambios.

Contribuir a ccmux Mejorar el sitio web o las traducciones

¿Detectó un error o algo desactualizado? Editar esta página en GitHub.