Para qué sirve el CLI
El CLI es el camino más corto entre un proyecto limpio y un bot ejecutable. Gestiona el scaffolding, la generación de archivos, el arranque en desarrollo, los builds de producción, la ejecución en runtime, la integración de base de datos y los diagnósticos desde una única interfaz coherente. Esa coherencia importa porque la línea de comandos es donde los equipos suelen perder tiempo en pasos de configuración repetidos, deriva de nombres o flujos medio manuales.
En la práctica, el CLI es más útil cuando dejas que cada comando haga un trabajo claro. new crea el workspace, generate agrega archivos alineados con el framework, dev ejecuta el bot activo, build valida la salida de producción y start ejecuta el artefacto compilado. Los comandos restantes respaldan flujos adyacentes como la configuración de base de datos y el diagnóstico del entorno.
Comandos disponibles
El CLI incluye siete comandos. Cada uno apunta a una fase distinta del ciclo de vida del proyecto, desde el scaffolding de un proyecto nuevo hasta la ejecución del artefacto compilado en producción.
Cómo encajan los comandos
Piensa en el CLI como un ciclo de vida, no como una bolsa de comandos sin relación:
- new crea la forma inicial del proyecto.
- generate mantiene los archivos nuevos alineados con las convenciones del framework.
- dev ofrece el ciclo de feedback más rápido durante la implementación.
- build es la puerta de calidad antes de compartir o desplegar.
- start ejecuta exactamente el artefacto de producción que acabas de compilar.
- database e info apoyan la configuración y el troubleshooting alrededor de ese ciclo.
Flujo diario recomendado
La mayoría de los equipos solo usa un subconjunto del CLI en el día a día. El ritmo habitual es hacer scaffolding una vez, generar cuando hace falta, quedarse en dev durante la implementación y usar build como comprobación final de confianza antes de publicar.
Haz scaffolding con new
Ejecuta spraxium new una vez para crear el proyecto. Elige tu plantilla y módulos opcionales durante el asistente interactivo.
Genera con generate
Usa spraxium generate para agregar módulos, servicios, listeners o comandos. El CLI coloca los archivos en la carpeta correcta y los registra automáticamente.
Itera con dev
Ejecuta spraxium dev durante la implementación. Los archivos se recargan automáticamente al guardar para que veas resultados al instante.
Valida con build
Ejecuta spraxium build antes de cada despliegue a un entorno compartido. Los errores de tipos y de bundle aparecen aquí, no en producción.
Publica con start
Ejecuta spraxium start en staging y producción después de un build exitoso. Lee directamente la salida compilada.
Uso local frente a CI
El desarrollo local suele girar en torno a generate y dev. CI normalmente se centra en build y, en algunos casos de depuración, info --json. Mantener clara esa separación ayuda a evitar forzar comandos interactivos dentro de la automatización o depender de comportamientos solo de desarrollo en pipelines de producción.
Elegir rápido el comando correcto
Si no tienes claro qué comando ejecutar, usa este atajo:
- Necesitas un proyecto nuevo: ejecuta spraxium new.
- Necesitas un nuevo archivo del framework: ejecuta spraxium generate.
- Necesitas recarga en caliente mientras codificas: ejecuta spraxium dev.
- Necesitas un artefacto desplegable: ejecuta spraxium build.
- Necesitas ejecutar el artefacto compilado: ejecuta spraxium start.
- Necesitas contexto del entorno: ejecuta spraxium info.