Comandos de utilidad
whatalo whoami, logout, info, doctor y upgrade — herramientas para gestionar tu sesión y entorno.
whatalo whoami
Muestra el desarrollador autenticado actualmente y los detalles de la sesión.
Sintaxis
whatalo whoami [opciones]Opciones
| Flag | Tipo | Descripción |
|---|---|---|
--portal-url <url> | string | URL del Portal del Desarrollador |
Salida
| Campo | Descripción |
|---|---|
| Email de tu cuenta de desarrollador | |
| Empresa | Nombre de la empresa asociada |
| Verificado | Si el email de tu cuenta está verificado |
| Sesión restante | Tiempo que queda en el token de acceso actual (se renueva automáticamente si expiró) |
Si tu token de acceso expiró pero el token de actualización sigue siendo válido, whatalo whoami lo renueva silenciosamente antes de mostrar la información.
Ejemplo
whatalo whoamiwhatalo logout
Cierra sesión y revoca tu token.
Sintaxis
whatalo logout [opciones]Opciones
| Flag | Tipo | Descripción |
|---|---|---|
--portal-url <url> | string | URL del Portal del Desarrollador |
Qué hace
- Envía una solicitud de revocación al portal para el token de actualización (best-effort, timeout de 5 segundos — continúa aunque la solicitud falle)
- Elimina
~/.whatalo/session.json
Ejemplo
whatalo logoutwhatalo info
Muestra información del proyecto y del entorno sin hacer llamadas a la API.
Sintaxis
whatalo info [opciones]Opciones
| Flag | Tipo | Descripción |
|---|---|---|
--json | boolean | Salida en JSON |
--portal-url <url> | string | URL del Portal del Desarrollador |
Secciones de salida
Proyecto (lee de whatalo.app.toml y package.json)
| Campo | Fuente |
|---|---|
| Nombre | whatalo.app.toml |
| Slug | whatalo.app.toml |
| ID del plugin | whatalo.app.toml |
| Puerto | Configuración dev en whatalo.app.toml |
| Versión | package.json |
Entorno (lee del sistema local)
| Campo | Descripción |
|---|---|
| Node.js | Versión instalada |
| CLI | Versión de @whatalo/cli |
| pnpm | Versión instalada |
| Vite | Versión de package.json |
| TypeScript | Versión de package.json |
| SDK | Versión de @whatalo/plugin-sdk |
Auth (lee de ~/.whatalo/session.json)
| Campo | Descripción |
|---|---|
| Cuenta autenticada | |
| Validez de sesión | Si la sesión está activa |
| URL del portal | URL del portal resuelta |
Ejemplo
whatalo info --jsonwhatalo doctor
Verifica tu entorno de desarrollo completo y reporta cualquier problema.
Sintaxis
whatalo doctor [opciones]Opciones
| Flag | Tipo | Descripción |
|---|---|---|
--json | boolean | Salida en JSON |
--verbose | boolean | Mostrar detalle también para las verificaciones que pasan |
--category <cat> | string | Ejecutar solo una categoría de verificaciones |
--portal-url <url> | string | URL del Portal del Desarrollador |
Categorías de verificación
Ejecuta una sola categoría con --category <nombre>.
system — Cadena de herramientas local
| Verificación | Requisito |
|---|---|
| Versión de Node.js | >= 18 |
| pnpm instalado | Cualquier versión |
| git instalado | Cualquier versión |
auth — Estado de la sesión
| Verificación | Qué se verifica |
|---|---|
| Archivo de sesión existe | ~/.whatalo/session.json presente |
| Sesión válida | El token de acceso o de actualización no ha expirado |
project — Proyecto plugin
| Verificación | Qué se verifica |
|---|---|
| Config presente | whatalo.app.toml encontrado |
| Plugin vinculado | plugin_id configurado en la config |
| SDK instalado | @whatalo/plugin-sdk en node_modules |
| Dependencias instaladas | node_modules presente |
network — Conectividad
| Verificación | Qué se verifica |
|---|---|
| Portal accesible | HTTP GET al endpoint de salud del portal |
| Registro npm accesible | HTTP GET a registry.npmjs.org |
| cloudflared disponible | Binario presente en ~/.whatalo/bin/cloudflared |
Total: 11 verificaciones en 4 categorías.
Códigos de salida
| Código | Significado |
|---|---|
0 | Todas las verificaciones pasaron |
1 | Una o más verificaciones fallaron |
Ejemplo
whatalo doctor
whatalo doctor --category network
whatalo doctor --verbose --jsonwhatalo upgrade
Verifica si hay una versión más reciente de @whatalo/cli y muestra el comando correcto para actualizar.
Sintaxis
whatalo upgrade [opciones]Opciones
| Flag | Tipo | Descripción |
|---|---|---|
--json | boolean | Salida en JSON |
Qué hace
- Consulta el registro de npm para la última versión de
@whatalo/cli - La compara con la versión instalada actualmente
- Si hay una versión más reciente, imprime el comando correcto de actualización según el gestor de paquetes detectado (pnpm, yarn o npm)
- No requiere autenticación
Ejemplo de salida (actualización disponible)
Versión actual: 1.2.0
Última versión: 1.5.0
Ejecuta para actualizar:
pnpm add -g @whatalo/cliEjemplo
whatalo upgradeComandos relacionados
whatalo login— Autenticarse- Descripción general del CLI — Ver todos los archivos de configuración