Comandos y Flags
Comando koko init
El comando principal para inicializar un nuevo proyecto en tu disco local:
Sintaxis: `koko init [nombre-del-proyecto] [flags]`
koko init mi-proyecto Referencia Completa de Flags
Todos los flags disponibles para automatizar la creación de proyectos sin interacción humana:
Inicializa inmediatamente usando la receta predeterminada (SaaS Starter con Next.js + Drizzle + Better-Auth).
Elige una receta de producción: saas, pern, mern, fastapi_react, enterprise_nestjs, java_spring, mobile_expo.
Framework frontend: nextjs, react, nuxt, svelte, astro, native, none.
Framework backend: express, hono, fastapi, go_chi, spring_boot, nestjs, self, none.
Capa de API tipada: trpc, orpc, none.
Gestor de paquetes: pnpm, npm, bun, go_mod, pip, uv, mvn, gradle.
Base de datos: postgres, mongodb, mysql, sqlite, none.
ORM o query builder: drizzle, prisma, mongoose, sqlalchemy, gorm, jpa, none.
Proveedor de autenticación: better-auth, clerk, next-auth, none.
Addons separados por coma: shadcn, lucide, svgl, motion, stripe, polar, resend, brevo, zod, docker, github_actions.
Inicializar repositorio Git local (por defecto: no).
Ejemplos para CI/CD y Scripts
Puedes integrar Koko CLI en scripts bash, Makefiles o flujos de CI/CD para generar estructuras reproducibles:
Inyección Dinámica de Addons (koko add)
El comando `koko add <addon>` te permite incorporar herramientas de infraestructura, pagos, autenticación o UI a un proyecto Koko existente semanas o meses después de su creación inicial, sin reconfiguración manual.
- stripe - Pagos globales con Stripe (añade STRIPE_SECRET_KEY y NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY).
- polar - Pagos y monetización de desarrolladores con Polar.sh.
- resend - Envío transaccional de correos electrónicos con SDK de Resend.
- brevo - Plataforma de marketing y emails transaccionales con Brevo.
- shadcn - Componentes base de UI y utilidades de Tailwind CSS.
- lucide - Paquete oficial de iconos optimizados Lucide Icons.
- zod - Tipado estricto y validación de esquemas en TypeScript.
- docker - Orquestación de contenedores y servicios con docker-compose.yml.
- github_actions - Workflows de CI/CD para compilación, testing y chequeos de integridad.
# Ejemplo: Inyectar pagos con Stripe en un proyecto existente
koko add stripe
# Ejemplo: Agregar servicio de emails con Resend
koko add resend
# Ejemplo: Incorporar componentes de shadcn/ui
koko add shadcn Comando koko doctor
Diagnostica la arquitectura del proyecto, detecta discrepancias y desviaciones (drift) respecto al manifiesto koko.config.json y actualiza la configuración automáticamente. Para una guía exhaustiva con ejemplos de CI/CD, consulta la sección dedicada de Diagnóstico.
Aplica automáticamente las correcciones y actualiza koko.config.json.
Especifica la carpeta del proyecto a analizar (por defecto: .).
Muestra la traza detallada de inspección de cada módulo y paquete.
Salida estructurada para pipelines automatizados de CI/CD.
# Diagnosticar estado del proyecto
koko doctor
# Diagnosticar y sincronizar manifiesto automáticamente
koko doctor --fix Comando koko version
Imprime en consola los detalles de la versión del CLI, sistema operativo, arquitectura de procesador y versión del compilador de Go con el que fue construido:
koko version