CLI

La CLI de Nuvem te permite gestionar proyectos, bases de datos, funciones y agentes desde la terminal.

Instalación

npm
pnpm

npm install -g @nuvem/cli

pnpm add -g @nuvem/cli

Autenticación

# Login interactivo (abre browser)
nuvem login

# Login con API key
nuvem login --key nv_live_...

# Ver estado
nuvem whoami

# Logout
nuvem logout

Proyectos

# Listar proyectos
nuvem projects list

# Crear proyecto
nuvem projects create --name "mi-saas"

# Seleccionar proyecto activo
nuvem projects use proj_abc123

# Ver proyecto activo
nuvem projects current

# Eliminar proyecto
nuvem projects delete proj_abc123

Base de datos

# Listar tablas
nuvem db tables

# Crear tabla (interactivo)
nuvem db create-table

# Ejecutar query SQL
nuvem db query "SELECT * FROM orders LIMIT 5"

# Importar CSV
nuvem db import --table products --file products.csv

# Exportar tabla
nuvem db export --table orders --format json > orders.json

# Aplicar migración
nuvem db migrate --file 0001_init.sql

Functions

# Listar funciones
nuvem functions list

# Crear función (scaffold)
nuvem functions create --name send-email --template http

# Deploy función
nuvem functions deploy --name send-email --file ./send-email.ts

# Invocar función
nuvem functions invoke send-email --payload '{"to":"user@email.com"}'

# Ver logs en tiempo real
nuvem functions logs send-email --tail

# Eliminar función
nuvem functions delete send-email

Storage

# Subir archivo
nuvem storage upload --file ./foto.jpg --path "avatars/foto.jpg"

# Descargar archivo
nuvem storage download --path "avatars/foto.jpg" --output ./foto-local.jpg

# Listar archivos
nuvem storage ls --prefix "avatars/"

# Eliminar archivo
nuvem storage rm "avatars/foto.jpg"

Agentes

# Listar agentes
nuvem agents list

# Crear agente (interactivo)
nuvem agents create

# Chat con un agente
nuvem agents chat soporte-latam

# Ver métricas
nuvem agents metrics --period 7d

# Ver runs
nuvem agents runs --agent soporte-latam --limit 10

Auth

# Listar usuarios
nuvem auth users

# Crear usuario
nuvem auth create-user --email usuario@email.com --password secret123

# Eliminar usuario
nuvem auth delete-user usr_abc123

API Keys

# Listar API keys
nuvem keys list

# Crear API key
nuvem keys create --name "produccion"

# Revocar API key
nuvem keys revoke key_abc123

Configuración

# Ver configuración actual
nuvem config

# Cambiar URL de API (para self-hosted)
nuvem config set apiUrl https://api.miempresa.com

# Cambiar proyecto por defecto
nuvem config set project proj_abc123

Variables de entorno

Variable	Descripción
`NUVEM_API_KEY`	API key del proyecto (override de `nuvem login`)
`NUVEM_PROJECT`	ID del proyecto activo
`NUVEM_API_URL`	URL de la API (por defecto: `https://api.nuvem-latam.com`)

MCP (Model Context Protocol)

La CLI expone un servidor MCP para integrar Nuvem en Claude Code, Cursor y otros clientes:

# Iniciar servidor MCP
nuvem mcp serve

# En Claude Code — agregar en .claude/mcp.json:
# {
#   "servers": {
#     "nuvem": {
#       "command": "nuvem",
#       "args": ["mcp", "serve"]
#     }
#   }
# }

Tools disponibles via MCP:

nuvem_db_query — ejecutar SQL
nuvem_db_list_tables — listar tablas
nuvem_functions_invoke — invocar función
nuvem_agents_chat — chatear con agente
nuvem_storage_list — listar archivos