Koko Koala Logo
Koko
0
CLI

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]`

Terminal
koko init mi-proyecto

Referencia Completa de Flags

Todos los flags disponibles para automatizar la creación de proyectos sin interacción humana:

  • -d, --default - Inicializa inmediatamente usando la receta predeterminada (SaaS Starter con Next.js + Drizzle + Better-Auth).
  • -r, --recipie <nombre> - Elige una receta de producción: saas, pern, mern, fastapi_react, enterprise_nestjs, java_spring, mobile_expo.
  • -f, --frontend <framework> - Framework frontend: nextjs, react, nuxt, svelte, astro, native, none.
  • -b, --backend <runtime> - Framework backend: express, hono, fastapi, go_chi, spring_boot, nestjs, self, none.
  • --api <capa> - Capa de API tipada: trpc, orpc, none.
  • -p, --package-manager <pm> - Gestor de paquetes: pnpm, npm, bun, go_mod, pip, uv, mvn, gradle.
  • --database <motor> - Base de datos: postgres, mongodb, mysql, sqlite, none.
  • --orm <mapeador> - ORM o query builder: drizzle, prisma, mongoose, sqlalchemy, gorm, jpa, none.
  • --auth <proveedor> - Proveedor de autenticación: better-auth, clerk, next-auth, none.
  • --addons <herramientas> - Addons separados por coma: shadcn, lucide, svgl, motion, stripe, polar, resend, brevo, zod, docker, github_actions.
  • --git <yes|no> - 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:

Scaffold MERN Stack Completo

Genera un monorepo con React SPA, Express TS API, MongoDB y Docker Compose:

Terminal
koko init app-mern -r mern

Scaffold FastAPI + React Vite

Genera frontend en React y backend en Python FastAPI con soporte asíncrono:

Terminal
koko init app-python -r fastapi_react

Scaffold API REST pura en Go Chi

Genera un backend modular en Go con PostgreSQL y GORM:

Terminal
koko init api-go -f none -b go_chi --database postgres --orm gorm -p go_mod

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.

✓ Sincronización en 1 clic: Utiliza --fix para actualizar el manifiesto y reparar inconsistencias de dependencias.
✓ Detección temprana: Encuentra colisiones de puertos en Docker y dependencias desfasadas antes de compilar.
  • -f, --fix - Aplica automáticamente las correcciones y actualiza koko.config.json.
  • -d, --dir <ruta> - Especifica la carpeta del proyecto a analizar (por defecto: .).
  • -v, --verbose - Muestra la traza detallada de inspección de cada módulo y paquete.
  • --json - Salida estructurada para pipelines automatizados de CI/CD.
Terminal
# 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:

Terminal
koko version
← Anterior Asistente TUI Interactivo CLI Siguiente → Diagnóstico (koko doctor) CLI