Referencia CLI

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

FlagTipoDescripción
--portal-url <url>stringURL del Portal del Desarrollador

Salida

CampoDescripción
EmailEmail de tu cuenta de desarrollador
EmpresaNombre de la empresa asociada
VerificadoSi el email de tu cuenta está verificado
Sesión restanteTiempo 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 whoami

whatalo logout

Cierra sesión y revoca tu token.

Sintaxis

whatalo logout [opciones]

Opciones

FlagTipoDescripción
--portal-url <url>stringURL del Portal del Desarrollador

Qué hace

  1. 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)
  2. Elimina ~/.whatalo/session.json

Ejemplo

whatalo logout

whatalo info

Muestra información del proyecto y del entorno sin hacer llamadas a la API.

Sintaxis

whatalo info [opciones]

Opciones

FlagTipoDescripción
--jsonbooleanSalida en JSON
--portal-url <url>stringURL del Portal del Desarrollador

Secciones de salida

Proyecto (lee de whatalo.app.toml y package.json)

CampoFuente
Nombrewhatalo.app.toml
Slugwhatalo.app.toml
ID del pluginwhatalo.app.toml
PuertoConfiguración dev en whatalo.app.toml
Versiónpackage.json

Entorno (lee del sistema local)

CampoDescripción
Node.jsVersión instalada
CLIVersión de @whatalo/cli
pnpmVersión instalada
ViteVersión de package.json
TypeScriptVersión de package.json
SDKVersión de @whatalo/plugin-sdk

Auth (lee de ~/.whatalo/session.json)

CampoDescripción
EmailCuenta autenticada
Validez de sesiónSi la sesión está activa
URL del portalURL del portal resuelta

Ejemplo

whatalo info --json

whatalo doctor

Verifica tu entorno de desarrollo completo y reporta cualquier problema.

Sintaxis

whatalo doctor [opciones]

Opciones

FlagTipoDescripción
--jsonbooleanSalida en JSON
--verbosebooleanMostrar detalle también para las verificaciones que pasan
--category <cat>stringEjecutar solo una categoría de verificaciones
--portal-url <url>stringURL del Portal del Desarrollador

Categorías de verificación

Ejecuta una sola categoría con --category <nombre>.

system — Cadena de herramientas local

VerificaciónRequisito
Versión de Node.js>= 18
pnpm instaladoCualquier versión
git instaladoCualquier versión

auth — Estado de la sesión

VerificaciónQué se verifica
Archivo de sesión existe~/.whatalo/session.json presente
Sesión válidaEl token de acceso o de actualización no ha expirado

project — Proyecto plugin

VerificaciónQué se verifica
Config presentewhatalo.app.toml encontrado
Plugin vinculadoplugin_id configurado en la config
SDK instalado@whatalo/plugin-sdk en node_modules
Dependencias instaladasnode_modules presente

network — Conectividad

VerificaciónQué se verifica
Portal accesibleHTTP GET al endpoint de salud del portal
Registro npm accesibleHTTP GET a registry.npmjs.org
cloudflared disponibleBinario presente en ~/.whatalo/bin/cloudflared

Total: 11 verificaciones en 4 categorías.

Códigos de salida

CódigoSignificado
0Todas las verificaciones pasaron
1Una o más verificaciones fallaron

Ejemplo

whatalo doctor
whatalo doctor --category network
whatalo doctor --verbose --json

whatalo 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

FlagTipoDescripción
--jsonbooleanSalida 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/cli

Ejemplo

whatalo upgrade

Comandos relacionados

On this page