Aprende el ciclo de Comal sin conectar una cuenta. Al terminar habrás iniciado una sesión, visto operaciones con recibos y encontrado cómo reanudarla. ## Antes de empezar Necesitas **Node.js 22 o posterior** y npm. Comal aloja su núcleo en Node, pero puede trabajar en proyectos de cualquier lenguaje disponible en tu entorno. ```sh npx @milpa/comal ``` Puedes ejecutarlo desde tu proyecto, sin clonar el repositorio. El primer arranque muestra cómo conectar tu modelo o probar la demo. Usa el nombre completo `@milpa/comal`; `comal` sin scope en npm corresponde a otro proyecto. Para dejar el comando global disponible: ```sh npm install --global @milpa/comal comal --help ``` Si tu prefijo global requiere permisos, usa `npm install --global --prefix "$HOME/.local" @milpa/comal` y agrega `$HOME/.local/bin` a tu PATH. No necesitas crear un alias de shell ni desplegar el backend. Para búsquedas de código instala también `rg` (ripgrep). ## 1. Prepara un terreno de práctica ```sh mkdir -p /tmp/comal-practica comal --cwd /tmp/comal-practica --demo ``` `--demo` usa un guion determinista: no es una respuesta de un modelo y no requiere credenciales. Puede crear su archivo de ejemplo dentro del workspace de práctica. El directorio de `--cwd` debe existir. ## 2. Completa una vuelta Escribe en el composer: ```text Muestra el ciclo de herramientas ``` Observa las operaciones, su estado y la respuesta. Después consulta: ```text /house /audit ``` `/house` muestra ejecución y recibos. `/audit` verifica lo registrado; ninguna de estas consultas demuestra por sí sola que un encargo arbitrario esté bien resuelto. ## 3. Guarda el punto de regreso Sal con `/exit`. Comal imprime el UUID de la sesión y el comando de reanudación. Conserva ese identificador: ```sh comal --cwd /tmp/comal-practica --demo --resume UUID ``` Sustituye `UUID` por el valor real. También puedes listar sesiones con `comal --cwd /tmp/comal-practica sessions`. Si prefieres no instalar globalmente, sustituye `comal` por `npx @milpa/comal` en estos ejemplos. ## Actualizar y conectar cuentas `npm install --global @milpa/comal@VERSION` instala la versión elegida. No hay actualización silenciosa. `npm uninstall --global @milpa/comal` quita el cliente y conserva tus sesiones de proyecto. Usa el mismo prefijo si elegiste uno al instalar. El login del modelo y tu cuenta de Artifacts son independientes: `comal cloud login` abre la conexión con la casa pública y pide que apruebes la CLI desde tu navegador. Consulta [Artifacts](artifacts) y [Login de proveedores](login). Para trabajar con código no necesitas una cuenta de Artifacts. La primera distribución se verifica en Linux con Node 22; macOS y Windows mediante WSL2 requieren verificación en esos entornos. No se afirma soporte de Windows nativo. El modelo no viene incluido; configura tu endpoint o proveedor siguiendo [Modelos](modelos). ## Comprueba lo aprendido - Puedes señalar qué se pidió y qué operación se ejecutó. - Puedes encontrar su recibo sin pedirle al modelo que lo invente. - Puedes cerrar y reanudar el mismo UUID. Ahora sigue con [Pedir, construir, verificar](primera-tarea), o conecta un [modelo real](modelos).