degausai/wonda

Wonda CLI

Wonda CLI es un kit de herramientas de creación de contenido para agentes basados en terminal. Úsalo para generar imágenes, videos, música y audio; editar y componer medios; publicar en plataformas sociales; e investigar y automatizar en LinkedIn, Reddit y X/Twitter.

Instalación

Si wonda no se encuentra en el PATH, instálalo primero. Las instalaciones recomendadas son los instaladores de escritorio firmados (CLI + icono de bandeja + relay siempre activo, sin pasos adicionales): macOS brew install --cask degausai/tap/wonda-app (o wonda-macos.pkg desde releases), Windows winget/wonda-windows-setup.exe. Los canales solo CLI a continuación funcionan en cualquier lugar y luego se puede agregar la aplicación de escritorio con wonda app install:

# npm
npm i -g @degausai/wonda

# Homebrew
brew tap degausai/tap && brew install wonda

Configuración

• Autenticación: wonda auth login (abre el navegador, recomendado) o establece la variable de entorno WONDA_API_KEY
• Verificación: wonda auth check

Autenticación del conector OAuth

Los conectores Claude Web y Cowork utilizan el flujo OAuth 2.1 de Wonda en lugar de un campo de clave API en la CLI. El conector inicia sesión a través de Wonda en el navegador, concede el acceso solicitado a la cuenta y recibe tokens OAuth vinculados al recurso de la API de Wonda. El servidor intercambia esos tokens por la clave API interna de la cuenta solo dentro de Wonda, por lo que los agentes y hosts del conector nunca ven la clave sk_.... Para la CLI y la ruta local stdio MCP, sigue usando wonda auth login o WONDA_API_KEY.

Relay local de Claude Cowork

Claude Cowork (la aplicación de escritorio) ejecuta servidores MCP locales en el host, por lo que puede cargar el paquete .mcpb o una configuración local stdio wonda-mcp directamente, incluidas las escrituras WAB (verificado el 2026-07-07). Claude Web no puede. El relay local de Wonda es la ruta alternativa: permite que el conector REMOTO (web o Cowork) ejecute acciones en el propio Mac del usuario y su IP residencial sin necesidad de configuración MCP local:

1. Abre https://wonda.sh/download mientras estás conectado e instala el paquete notarizado de Mac.
2. Vincula el relay con wonda relay pair o el traspaso del navegador en el primer inicio. Esto utiliza el flujo cli-auth existente con una credencial wrelay_... con alcance de relay almacenada en el Llavero de macOS. No le pidas al usuario que pegue una clave API o un código de dispositivo.
3. Abre https://wonda.sh/setup, conecta LinkedIn, X y Reddit a través del WAB local con interfaz gráfica, luego aprueba el conector Wonda una vez en Claude.

La política del motor es auto | my_machine | cloud. auto usa el relay local cuando está en línea y cloud en caso contrario. my_machine no debe retroceder silenciosamente: si el relay está fuera de línea, pregunta si se desea cambiar a cloud.

Organizaciones y contexto de gasto

Las organizaciones Wondercat son carteras compartidas con sus propios asientos y facturación. Los miembros pueden gastar de la cartera de la organización (en lugar de sus créditos personales) cambiando de contexto:

• wonda organizations list (alias: wonda orgs list, wonda org list) — ve cada organización a la que perteneces con tu rol y plan de asiento en cada una.
• wonda use --org <slug> — contexto de organización persistente para esta máquina. Establece X-Wonda-Org en cada solicitud; las retenciones, cargos y wonda balance se realizan a través de la cartera de la organización.
• wonda use --personal — vuelve a lo personal.
• wonda usage — resumen de uso solo de gastos (total + desglose por modelo + por proyecto) para un período (--month 2026-05, o --from/--to; por defecto el mes actual, UTC). --project <nombre> restringe el informe a un proyecto. En contexto de organización, informa el uso de toda la organización, incluido un desglose por miembro (se requiere rol de administrador/propietario). Los administradores también pueden descargar un informe completo en Excel desde la página de la organización en la web.

Proyectos (etiquetado de gastos)

Los proyectos atribuyen el gasto a un flujo de trabajo con nombre para su monitoreo. Los agentes deben verificar el proyecto activo al inicio de la tarea (wonda use lo imprime) y establecer uno por tarea cuando el operador monitorea el gasto por proyecto:

• wonda use --project <nombre> — persistente: cada cargo posterior lleva el proyecto (en wonda usage, la API y el informe Excel de la organización). wonda use --no-project detiene el etiquetado; cambiar al contexto de organización/personal borra el proyecto automáticamente (los proyectos son por ámbito).
• --project <nombre> en cualquier comando — anulación única para esa invocación.
• wonda project list|create|delete — gestiona el registro en el ámbito activo. Los proyectos de organización solo los crean los administradores/propietarios de la organización; los proyectos personales son de autoservicio. Etiquetar contra un nombre que no existe falla con unknown_project (sin nuevos buckets silenciosos, por lo que los errores tipográficos no pueden dividir los datos de monitoreo).

wonda topup siempre recarga tu cartera personal, independientemente del contexto. Recargar la cartera de la organización (y configurar la recarga automática) es solo para administradores y se realiza en la web en /organizations/<slug>. Si un miembro se queda sin créditos de la organización, el error le indica que solicite a un administrador o vuelva al contexto personal; no puede recargar la cartera de la organización desde la CLI.

Los roles dentro de una organización son independientes del plan de asientos:

• Propietario: el creador original. No puede ser degradado ni expulsado. Puede transferir la propiedad a otro miembro desde la página de la organización (raro).
• Administrador: puede invitar (individual o masivamente mediante pegado), expulsar, cambiar roles, cambiar asientos, recargar, configurar la recarga automática, cambiar límites mensuales.
• Usuario: solo puede gastar dentro de la cartera de la organización (sujeto a un límite mensual por miembro si el administrador lo estableció).

Un asiento de organización pago (WONDA / WONDA_PREMIUM) otorga el mismo acceso a funciones premium (skills, etc.) que un plan personal pago, pero solo en el contexto de la organización. wonda use --personal vuelve al plan de la cuenta personal del usuario.

Niveles de acceso

Wonda es solo de pago: cada superficie del producto requiere un plan pago, incluyendo llamadas API, lecturas de plataforma local, automatización del navegador, composición de medios, edición de archivos, diagnósticos, generación, publicación, scraping, análisis, skills, operación del relay y twin en la nube. Antes de que cualquier comando de producto realice trabajo, la CLI realiza una verificación de derechos en vivo contra Wonda. La verificación falla de manera segura cuando no se puede verificar el acceso. Las cuentas nuevas no obtienen acceso al producto hasta que se suscriben, y un saldo de crédito positivo no sustituye a un plan.

Nivel	Acceso
Anónimo (sin inicio de sesión)	Sin acceso al producto. La autenticación, configuración, precios, descubrimiento/selección de organización, autocompletado de shell y comandos de apagado local permanecen disponibles para que el usuario pueda suscribirse, recuperarse o detener servicios en segundo plano. Ejecuta wonda auth login, luego suscríbete.
Gratuito (conectado, sin plan pago)	Sin acceso al producto. Suscríbete en https://wonda.sh/account para usar el producto.
WONDA ($19.99/mes, "Pro")	Todo excepto el twin en la nube: generación (image/generate, video/generate, ...), subida/descarga de medios, publicación, scraping, análisis, análisis de video, skills (wonda skill install/list/get), transiciones, recorte, correo electrónico, creación de cuentas de reddit/linkedin, estilos, marca.
WONDA_PREMIUM ($49.99/mes, "Premium")	Todo lo de WONDA, más twin en la nube (wonda twin: aprovisionamiento, ejecuciones programadas, inicio de sesión transmitido) con protección antidetect / shadowban, sin límites y creación de cuentas en EE. UU.
Marcado (interruptores de seguridad por cuenta PostHog)	Incluido en el plan pago pero aún controlable por una bandera por cuenta: wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), enriquecimiento de perfil público de LinkedIn (linkedinProfileEnrichmentEnabled).

Si un comando devuelve un 403 (paid_plan_required), suscríbete en https://wonda.sh/account.

Esto también se aplica a la ruta local stdio MCP porque MCP ejecuta la misma CLI. Las cookies y datos de la plataforma permanecen en el dispositivo, pero el comando primero debe recibir una decisión exitosa de acceso pago desde GET /api/v1/auth/access. Una instalación solo de relay puede usar su credencial wrelay_... con alcance para esa sonda de derechos. La credencial con alcance aún no puede llamar a las API de cuenta ordinarias.

Clonación de voz

Clona una voz a partir de un clip de audio de 10 segundos o más y úsala en TTS. Límite estricto: 20 voces clonadas por cuenta. Costo: $1.50 por clonación.

# Clonar desde un archivo local (se sube automáticamente a la biblioteca de medios primero)
wonda voice create "Andu" --file ./sample.mp3 --description "Mi voz"

# Clonar desde un medio existente de Wonda
wonda voice create "Marca" --media-id <uuid>

# Preprocesamiento opcional del audio fuente
wonda voice create "Limpia" --file ./raw.wav --noise-reduction --normalize-volume

# Listar voces clonadas (cada fila informa isExpired y expiresInDays)
wonda voice list

# Una voz
wonda voice get <voice-id>

# Renombrar / cambiar descripción (solo local, sin llamada al proveedor)
wonda voice update <voice-id> --name "Nuevo nombre" --description "..."

# Eliminar
wonda voice delete <voice-id>

Usa una voz clonada en TTS pasando el providerVoiceId de voice get como voiceId a /audio/speech:

wonda audio speech "Hola mundo" \
  --model minimax-speech-2-8-hd \
  --params '{"voiceId":"<providerVoiceId>"}'

Caducidad de 7 días: las voces clonadas que no se hayan usado en TTS dentro de los 7 días se caducan automáticamente. Ejecutar TTS con una voz clonada renueva automáticamente su caducidad. Las voces inactivas que caducan deben volver a clonarse ($1.50 de nuevo).

Bóveda de credenciales

Conserva los inicios de sesión creados en plataformas externas (Instagram, TikTok, Twitter, etc.) para que puedan reutilizarse en la siguiente ejecución. Las contraseñas se cifran con AES-256-GCM usando una clave del lado del servidor y solo se descifran al hacer get.

# Crear
wonda credentials create --website instagram.com --username miusuario \
  --email [email protected] --password-stdin <<< "cazador2" \
  --metadata '{"signup_source":"wonda-email"}'

# Listar (contraseñas omitidas)
wonda credentials list --website instagram.com

# Obtener registro completo incluida la contraseña descifrada
wonda credentials get <id>

# Actualizar cualquier campo (usa --password-stdin para rotar; --username "" para borrar)
wonda credentials update <id> --username nuevousuario

# Eliminar
wonda credentials delete <id>

# Obtener y registrar por qué lo estás usando en una sola llamada — POST, no GET, porque
# escribe un evento 'usado' con el motivo. Prefiere esto sobre `get` siempre que
# puedas articular el motivo.
wonda credentials use <id> --reason "flujo de registro en instagram"

# Ver eventos recientes (creado / usado / rotado / actualizado) para auditoría
wonda credentials events <id>

Campos: website (obligatorio — la entrada escrita como insta se canonaliza a instagram.com), username, email, password (obligatorio), metadata (JSON arbitrario). Al menos uno de username/email debe estar presente. Se permiten múltiples registros por (website, username) — desduplica por tu cuenta si es necesario.

Registro de eventos: cada credentials get/use, create, rotación de contraseña y otras actualizaciones se registran como eventos en la credencial (actor: cli | web | system). Usa credentials events <id> o el ícono de historial en la interfaz web para auditar. El registro de eventos es de solo añadidura y se elimina en cascada al borrar la credencial.

Banderas de salida globales

Todos los comandos admiten estas banderas de control de salida:

• --json — Forzar salida JSON (se habilita automáticamente cuando stdout está redirigido)
• --quiet — Solo mostrar el identificador principal (ID del trabajo, ID del medio, etc.) — ideal para scripting
• -o <ruta> — Descargar la salida a un archivo (implica --wait)
• --fields estado,salidas — Seleccionar campos JSON específicos
• --jq '.salidas[0].medio.url' — Filtrar la salida JSON con una expresión jq

Anuncios de CLI y advertencias de obsolescencia

En cada comando, la CLI consulta GET /api/v1/updates (anónimo, caché de 1 hora en ~/.wonda/state.json) en busca de anuncios activos: avisos de obsolescencia, alertas de incidentes, indicaciones de actualización. Los mensajes se imprimen solo en stderr, por lo que stdout/JSON permanece limpio para redirecciones.

Las sugerencias de obsolescencia por solicitud llegan como el encabezado HTTP estándar Warning: 299 - "<mensaje>" y se muestran en stderr por el cliente HTTP de la CLI como [deprecated MÉTODO /ruta] <mensaje>.

Silencia ambos canales con WONDA_QUIET=1 (variable de entorno) o --quiet (bandera). Deshabilita solo las comprobaciones de red con WONDA_NO_UPDATE_CHECK=1.

WAB / Wonda Automation Browser (wonda wab)

1Password está incluido en los perfiles locales de WAB. WAB descarga la extensión oficial estable de 1Password, verifica su firma de editor y la fija en la barra de herramientas en la primera configuración. Abre el WAB con wonda wab show <persona>, luego haz clic en 1Password para iniciar sesión. Cada persona mantiene su propia sesión de 1Password. La aplicación de escritorio puede requerir que apruebes WAB como un navegador adicional; iniciar sesión directamente en la extensión también funciona. Los archivos de extensión en caché funcionan sin conexión. WAB verifica las extensiones en caché en busca de actualizaciones como máximo una vez al día cuando se inicia una persona, incluidas las comprobaciones fallidas; cambiar la versión de Chromium desencadena otra comprobación de compatibilidad. Si la extensión nunca se ha instalado correctamente, cada inicio reintenta la instalación. Un navegador ya en ejecución recoge una actualización de la extensión en su próximo inicio. El inicio y wab install eliminan las versiones en caché no utilizadas de más de siete días; las versiones utilizadas por un proceso WAB activo se conservan. Establece WAB_ONEPASSWORD=0 antes de iniciar WAB para omitir la extensión incluida. Las capturas anónimas, las sesiones de prueba y los twins en la nube no la cargan. Una ruta de datos de Wonda que contenga una coma también omite 1Password con un dr