Instalación

El CLI de Whet (@whet/cli) es un binario Node escrito en TypeScript con Commander.js e Ink. Se conecta al Agent API de tu deployment con un bearer token y expone los mismos flujos que la UI del workbench.

Requisitos

• Node.js 20+ (probado en 20.x y 22.x).
• pnpm 9+ recomendado. npm y yarn también funcionan.
• Un deployment de Whet accesible vía HTTPS (o http://localhost:3000 si lo corrés local con bench-up.sh).
• Un agent token. Si no lo tenés, te lo entregamos durante el setup o lo generás desde la UI en Settings → Agent tokens.

Instalar

pnpm install -g @whet/cli
# o
npm install -g @whet/cli

Verificá que quedó instalado:

whet --version

Configurar la conexión

Guardá el token y la base URL una sola vez:

whet auth login \
  --token <agent-token> \
  --base-url https://your.vps/api/agent/v1

Esto escribe ~/.whet/config.json con permisos 600. El token nunca se loguea.

Confirmar

whet auth status

Devuelve la base URL configurada y los primeros caracteres del token (resto enmascarado). Si el deployment responde, vas a ver connected · agent token valid.

Siguiente paso

• whet install — bootstrap de laptop fresco para el stack en sí (Docker compose + secrets + migraciones).
• whet init — cableá tus MCP clients (Claude Code, Claude Desktop, Cursor) al deployment.
• whet pipelines new — crear tu primer pipeline.
• Referencia completa — todos los comandos y flags.

Troubleshooting

Command not found: whet — chequeá que el directorio global de tu package manager esté en $PATH. Para pnpm: pnpm setup. Para npm: npm config get prefix y agregá /bin al PATH.

401 Unauthorized — el token expiró o fue revocado. Generá uno nuevo desde la UI y volvé a correr whet auth login.

ECONNREFUSED — la base URL no responde. Si estás corriendo local, asegurate de que bench-up.sh esté corriendo y los puertos sean los esperados.