@nuvemlatam/cli

CLI oficial de Nuvem — el Backend-as-a-Service edge-native sobre Cloudflare.

Semana 1: solo dos comandos — init y status. El CLI apunta al API control-plane corriendo en apps/api.

Comandos

nuvem init <name>

Crea un nuevo proyecto Nuvem en el directorio actual, registra el proyecto en el API, genera una API key inicial y la guarda en .env.local.

nuvem init demo --local

Flags:

• --local — usar el API en http://localhost:8787 (default: https://api.nuvem-latam.com)
• --force — sobreescribir .nuvem/ y .env.local si ya existen

Archivos generados:

• .nuvem/config.json — metadata del proyecto (id, nombre, apiUrl)
• .env.local — NUVEM_API_KEY, NUVEM_PROJECT_ID, NUVEM_API_URL

La API key se muestra una sola vez. Guardala en tu gestor de secretos.

nuvem status

Verifica conectividad con el API y muestra el estado del proyecto.

nuvem status --local

Hace un GET /health (con latencia) y un GET /v1/projects/<id> autenticado con la key guardada en .env.local.

Desarrollo

# Desde la raíz del monorepo
pnpm --filter @nuvemlatam/cli build
pnpm --filter @nuvemlatam/cli dev      # watch mode

# Correr el binario compilado
node packages/cli/dist/cli.js init demo --local
node packages/cli/dist/cli.js status --local

Stack

• Node.js >= 22, ESM
• TypeScript strict
• commander — parsing de args
• picocolors — colores
• prompts — confirmaciones interactivas
• tsup — bundler ESM con shebang

Errores

Los mensajes de error son bilingües (ES/PT) porque Nuvem es LATAM-first. El cliente muestra primero español, después portugués en gris.

Week 1 scope

• No hay comando login todavía — la primera API key se genera sin auth durante init.
• El dominio api.nuvem-latam.com no está desplegado. Usá --local mientras corrés apps/api con wrangler dev.
• Tests llegan en Week 2.