Tutorial 1: Tu primer proyecto
El bucle central: crear un proyecto → iniciar la sesión del agente → adjuntar → trabajar → desconectar.
1. Crear un proyecto en el TUI
Abrir ccmux:
ccmux
Presione 2 para ir a la pantalla Proyectos, luego n para abrir el formulario de nuevo proyecto.
Complete:
- Nombre — el nombre del directorio del proyecto (p. ej.
api-service) - Anfitrión — en qué máquina ejecutarlo (el valor predeterminado es local)
- Agente — Claude, Codex, Antigravity, Cursor, pi o Grok; utilizar
←/→para ciclar
Presione Enter para crear el directorio e iniciar la sesión. ccmux vuelve a la pantalla de inicio donde aparece inmediatamente la nueva sesión.
Acceso directo CLI. Si prefieres la línea de comando:
ccmux new api-serviceMismo resultado: directorio creado en
projects.root, La sesión tmux se inició con el agente predeterminado (o el almacenado en<project>/.ccmux/agent).
2. Adjuntar a la sesión
En la pantalla de inicio, navegue hasta la sesión con j / k y presione Enter para adjuntar.
Ahora estás dentro de la sesión tmux ejecutando tu agente. Cuando hayas terminado:
Ctrl-b d— desconectar; ccmux TUI se reanuda automáticamente- La sesión sigue ejecutándose en segundo plano
3. Verificar el estado sin adjuntar
Puede leer el estado de la sesión desde el panel sin interrumpir al agente. El needs_input El indicador (rojo) es el que debe observar: significa que el agente está esperando su respuesta.
Para enumerar sesiones desde el shell:
ccmux list
4. Notas del proyecto
Presione 4 en el TUI para abrir el Notas pestaña para este proyecto. Cada .md el archivo en el árbol del proyecto aparece en una lista agrupada por carpetas; seleccionar uno lo renderiza con Glamour.
Presione / para buscar en todas las notas con ripgrep.
La desconexión deja la sesión ejecutándose en tmux mientras el host permanece despierto. La protección de suspensión predeterminada macOS funciona con alimentación de CA y no anula la suspensión de cierre de la tapa. Revisa el configuración de sueño antes de dejar una computadora portátil desatendida.
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.
¿Detectó un error o algo desactualizado? Editar esta página en GitHub.
