Descripción general del CLI

Instala y autentica el CLI de Whatalo — 14 comandos para el ciclo completo de desarrollo de plugins.

Instalación

Instala el CLI globalmente con pnpm:

pnpm add -g @whatalo/cli

O ejecútalo sin instalación global:

npx @whatalo/cli whatalo login

Verifica la instalación:

whatalo --version

Autenticación

El CLI utiliza el flujo RFC 8628 Device Authorization Grant. Nunca escribes tu contraseña en la terminal.

Cómo funciona

Ejecuta whatalo login
El CLI contacta el Portal del Desarrollador y obtiene un código de dispositivo
Tu navegador se abre automáticamente con una página de verificación
Aprueba la solicitud en el navegador
El CLI consulta cada 5 segundos hasta que apruebes
Al tener éxito, los tokens se guardan en ~/.whatalo/session.json

Ciclo de vida de los tokens

Token	TTL	Comportamiento
Token de acceso	1 hora	Se renueva automáticamente antes de expirar
Token de actualización	30 días	Rotación de un solo uso — se emite un nuevo token en cada renovación

Los permisos del archivo de sesión se establecen automáticamente: directorio 700, archivo 600.

Resolución de la URL del portal

Cada comando resuelve la URL del Portal del Desarrollador en este orden de prioridad:

Prioridad	Fuente
1 (mayor)	Flag `--portal-url <url>`
2	Variable de entorno `WHATALO_DEVELOPER_PORTAL_URL`
3 (por defecto)	`http://localhost:3002`

Archivos de configuración

Archivo	Ubicación	Propósito
`whatalo.app.toml`	Raíz del proyecto	Config del proyecto — nombre, slug, comandos de build, puerto dev
`whatalo.app.ts`	Raíz del proyecto	Manifiesto del plugin — permisos, URLs, páginas de administrador
`~/.whatalo/session.json`	Directorio home	Tokens de auth (gestionados automáticamente, no editar manualmente)
`.whatalo/dev-store.json`	Raíz del proyecto	Caché de la tienda de desarrollo seleccionada

Verificación de versión en segundo plano

En cada ejecución, el CLI verifica en npm si hay una versión más reciente de @whatalo/cli. Los resultados se guardan en caché por 24 horas en ~/.whatalo/version-check.json. Si hay una versión nueva, se muestra una notificación en stderr — nunca bloquea el comando en ejecución.

Todos los comandos

Comando	Descripción
`whatalo login`	Autenticar mediante Device Flow en el navegador
`whatalo logout`	Cerrar sesión y revocar el token
`whatalo whoami`	Mostrar información del desarrollador actual
`whatalo init`	Crear un nuevo proyecto de plugin interactivamente
`whatalo dev`	Iniciar desarrollo local con túnel en vivo
`whatalo deploy`	Compilar y desplegar una nueva versión del plugin
`whatalo validate`	Validar la configuración y el manifiesto del proyecto
`whatalo logs`	Ver y transmitir logs de entrega de webhooks
`whatalo env pull`	Descargar variables de entorno a `.env`
`whatalo env show`	Mostrar variables de entorno (solo lectura)
`whatalo webhook trigger`	Enviar un webhook de prueba a tu plugin
`whatalo info`	Mostrar información del proyecto y entorno
`whatalo doctor`	Verificar el entorno de desarrollo
`whatalo upgrade`	Verificar actualizaciones del CLI

Flags globales

Estos flags son aceptados por todos los comandos:

Flag	Descripción
`--portal-url <url>`	Sobreescribir la URL del Portal del Desarrollador
`--help`	Mostrar ayuda del comando
`--version`	Mostrar versión del CLI

On this page