Introducción
Inicio Rápido
Filosofía de Koko CLI
✓ Arranque Instantáneo en Milisegundos: Construido en Go con binario nativo que se ejecuta de inmediato sin sobrecargas de configuración previa.
✓ TUI Interactiva Premium: Asistente visual en consola impulsado por Bubble Tea y Lipgloss con animaciones y spinners en tiempo real.
✓ Monorepo y Workspaces por Defecto: Configuración automática de Turborepo, pnpm workspaces, TypeScript unificado y ESLint/Prettier.
✓ Validación Cruzada Inteligente: Sistema de reglas que previene activamente la combinación de tecnologías incompatibles en tiempo de diseño.
✓ Catálogo Maestro de Dependencias: Gestión centralizada de versiones para garantizar instalaciones reproducibles y código libre de drift.
Prerrequisitos e Instalación
Puedes ejecutar Koko CLI directamente desde la nube usando Node.js o descargar el binario nativo compilado en Go según tu preferencia:
- Node.js (LTS v18 o superior) - Recomendado para ejecutar y compilar los proyectos generados en JavaScript/TypeScript.
- Docker & Docker Compose - Opcional pero recomendado para levantar bases de datos locales (PostgreSQL, MongoDB, MySQL).
- Go 1.21+ / Python 3.11+ - Necesarios únicamente si generas backends nativos en Go Chi o Python FastAPI.
# Opción 1: Ejecutar directamente con NPX (sin instalación permanente)
npx koko-app init
# Opción 2: Instalación global con npm/pnpm
npm install -g koko-app
koko init Binarios Nativos (GitHub Releases)
Si prefieres no depender de Node.js global, puedes descargar el ejecutable nativo de Koko para tu sistema operativo desde los Releases oficiales de GitHub:
Modos de Inicialización
Koko CLI ofrece dos modos de uso interactivo diseñados para maximizar tu productividad:
✓ Quick Setup (Recetas de Producción): Selecciona un preset completo probado en producción (SaaS Starter, Java Spring Boot, Enterprise NestJS, MERN, PERN o FastAPI + React) y comienza a codificar en 2 segundos.
✓ Manual Configuration (Configuración Paso a Paso): Diseña tu stack pieza por pieza eligiendo Frontend, Backend, Base de Datos, ORM, Addons y Git con validación en tiempo real.
Integración con Stack Builder Web
✓ También puedes usar nuestro constructor visual interactivo en /builder para seleccionar tus tecnologías mediante tarjetas interactivas.
✓ El constructor genera el comando CLI exacto con todos los flags correspondientes para que lo copies y ejecutes en tu terminal con un solo clic.
Resumen de Comandos y Flags
Comandos rápidos para crear proyectos de inmediato omitiendo el asistente interactivo:
# Crear con la receta predeterminada (SaaS Starter con Next.js + Drizzle + Better-Auth)
koko init mi-saas -d
# Crear seleccionando una receta específica
koko init mi-app -r pern
# Crear con stack manual por flags
koko init mi-api -f none -b express --database postgres --orm drizzle -p pnpm --git yes