Hay un momento que todo developer conoce.

Abres el editor. Tienes una idea clara. Sabes exactamente lo que quieres construir. Y entonces — antes de escribir una sola línea de código real — te toca hacer lo de siempre: inicializar el proyecto, configurar TypeScript, instalar Tailwind, escribir el Dockerfile, montar el pipeline de CI, decidir qué ORM usar, configurar ESLint...

Una hora después sigues sin haber tocado lo que querías construir.

Eso es lo que quería resolver.

Cómo nació

No lo planifiqué como un proyecto. Nació de la frustración acumulada de hacer siempre lo mismo.

Trabajo en múltiples stacks — Next.js, Hono, FastAPI, Go — dependiendo del proyecto. Cada vez que empezaba algo nuevo, copiaba configuraciones de repos anteriores, ajustaba paths, borraba lo que no aplicaba, olvidaba algo importante, lo añadía después. El proceso era manual, inconsistente y aburrido.

Un día decidí que la próxima vez que fuera a copiar un docker-compose.yml por enésima vez, mejor lo automatizaba. Eso fue el primer commit de sgomez-cli. Lo que empezó como un script personal acabó siendo una CLI completa con soporte para 14 frameworks y 11 features adicionales.

Qué hace exactamente

sgomez-cli cubre tu workflow completo — desde el día 0 hasta producción. No es un generador de boilerplate. Es la herramienta que hace todo lo que haces tú antes de ponerte a programar de verdad.

Scaffolding interactivo

sgomez init

Te guía paso a paso: frontend, backend, o fullstack. Elige el framework, el lenguaje, los add-ons. Al final tienes un proyecto listo con git inicializado y la opción de abrirlo en VS Code, Cursor, WebStorm o Zed.

Frontends soportados: React (Vite), Next.js, Vue 3, Nuxt, SvelteKit, Astro, Remix, Angular

Backends soportados: Express, NestJS, Hono (Bun), FastAPI, Django, Go

El modo fullstack crea un monorepo con frontend/ y backend/ separados.

Modo rápido — sin prompts

Si ya sabes lo que quieres:

sgomez create my-saas --next --hono --ts --tailwind --docker --ci --git

Una línea. Proyecto completo.

Añadir features a proyectos existentes

sgomez add docker     # Dockerfile multi-stage + docker-compose + PostgreSQL + Redis
sgomez add ci         # GitHub Actions o GitLab CI con matrix testing
sgomez add db         # Prisma, Drizzle, Mongoose o SQLAlchemy
sgomez add auth       # JWT o session auth
sgomez add test       # Vitest, Jest, Playwright o pytest
sgomez add api users  # CRUD completo: list, get, create, update, delete
sgomez add component UserCard  # Componente tipado con props interface

Esto es lo que más uso en el día a día. Estoy a mitad de un proyecto, necesito añadir autenticación — sgomez add auth y listo. Sin buscar documentación, sin copiar de otro repo.

Health check del sistema

sgomez doctor

  ✓ Node.js      v22.4.0
  ✓ Git          2.45.2
  ✓ Python 3     3.13.0
  ✓ Docker       27.0.3
  ○ Bun          not installed
  ○ Rust         not installed

  Summary: 8 installed · 3 missing

Útil cuando configuras una máquina nueva o incorporas a alguien al equipo.

Por qué usarlo

No voy a decirte que es la mejor CLI del mundo. Te voy a decir lo que hace por mí:

Me devuelve tiempo. El setup de un proyecto nuevo que antes me costaba 45-60 minutos, ahora son 2. Eso en un mes suma horas reales.

Elimina las inconsistencias. Todos mis proyectos tienen la misma estructura base, los mismos patrones de CI, las mismas convenciones de Docker. Cuando salto de uno a otro no hay fricción mental.

Funciona en el stack que ya usas. No te obliga a nada. Si usas FastAPI + React, ahí está. Si prefieres Hono + SvelteKit, también. Si mañana cambias de opinión, puedes añadir lo que necesites con sgomez add.

Instalación

npm install -g sgomez-cli

Node.js ≥18 requerido. Python, Go, Bun y Docker son opcionales — solo los necesitas si los usas.

El código está en github.com/sgomez-dev/sgomez-cli, MIT license, contribuciones bienvenidas.

Lo que viene

El roadmap tiene cosas interesantes: sgomez deploy para hacer deploy directo a Vercel, Railway o Fly.io con un comando, soporte para Turborepo y Nx, integraciones con Supabase y Firebase, y un sistema de plugins para que la comunidad pueda añadir sus propios generadores.

Si lo usas y encuentras algo que no funciona o algo que debería estar y no está — abre un issue. Lo leo.

Nos leemos.

— Santi