Help Center

Wave CLI

Instala el comando wave, inicia sesión desde tu navegador, y lista, busca, exporta y organiza tus grabaciones desde la terminal.

Última actualización:

La Wave CLI lleva tus grabaciones a la terminal. Es un paquete de npm llamado @waveai/cli que instala un comando wave, con el que puedes listar sesiones, buscarlas, imprimir una transcripción, descargar audio, o redirigir cualquiera de estas salidas a un script. Todo comando que devuelve datos acepta --json, lo que facilita combinarlo con otras herramientas.

Es gratuito en todos los planes de Wave y requiere Node.js 20 o superior. Funciona en macOS, Linux y Windows.

Instalación

npm install -g @waveai/cli

Para probarlo sin instalar nada:

npx @waveai/cli sessions list

Inicia sesión

Ejecuta:

wave login

Tu navegador abre una página Authorize Wave CLI ("Autorizar Wave CLI") que muestra la cuenta con la que iniciaste sesión y qué podrá hacer la CLI. Haz clic en Authorize Wave CLI, y la página confirma con Wave CLI is authorized — You can close this tab and go back to your terminal. La terminal recoge la credencial e indica cuántas sesiones tienes.

Iniciar sesión de esta manera crea un token de API llamado Wave CLI con todos los permisos de la API —incluyendo eliminar sesiones de forma permanente y compartirlas— aunque la página de autorización liste menos permisos. Si quieres algo más acotado, omite el flujo del navegador: crea un token con solo los permisos que necesitas en la página de Developer API y ejecuta wave login --token wave_api_... en su lugar.

Otras dos formas de autenticarte:

  • wave login --token wave_api_... — pega un token que hayas creado tú mismo. Ideal para CI y máquinas sin interfaz gráfica.
  • Define una variable de entorno WAVE_API_KEY. Tiene prioridad sobre lo que haya guardado wave login, lo que facilita ejecutar un comando con una cuenta distinta.

wave whoami muestra la cuenta, el estado de la suscripción y la cantidad de sesiones. wave logout borra la credencial guardada en esta máquina.

Para desconectar una máquina que ya no controlas, revoca el token llamado Wave CLI en la aplicación web de Wave, en Settings → Developers → API tokens and webhooks ("Configuración → Desarrolladores → Tokens de API y webhooks"). Eso lo invalida en todos los lugares donde se usó.

Los comandos

Sesiones

  • wave sessions list — con --limit (hasta 100), --cursor, --since (acepta 7d, 2w, 1m), --type, --folder (id o nombre), --tag (puede repetirse) y --tag-mode.
  • wave sessions get <id> — metadatos, resumen, notas, etiquetas y detalles de llamada telefónica de una sesión.
  • wave sessions update <id> — define --title, --notes, --tags, --favorite / --no-favorite.
  • wave sessions add-folder <session_id> <folder_id> y wave sessions remove-folder — las carpetas no son excluyentes, así que agregar una no elimina otra.
  • wave sessions action-items get <session_id> y wave sessions action-items update <session_id> — lee los elementos de acción junto con su versión, y luego vuelve a escribirlos desde stdin o --from-file, opcionalmente protegido con --if-match para que una edición simultánea en la app sea rechazada en vez de sobrescrita.
  • wave sessions delete <id> — es permanente, y pide confirmación a menos que pases --force.

Contenido

  • wave search "tu consulta" — búsqueda semántica, con --limit (hasta 50), --tag y --tag-mode.
  • wave transcript <id> — imprime una transcripción. --format acepta text (el valor predeterminado), srt o segments; --speakers cambia a una salida con los hablantes identificados, y --json devuelve la respuesta sin procesar.
  • wave media urls <id> — URLs firmadas de audio y video.
  • wave media download <id> — guarda el audio; agrega --video para obtener MP4 o --output para especificar una ruta.
  • wave bulk [ids...] — exporta hasta 50 sesiones a la vez, con --summary y --transcript. --file lee los ids desde un archivo, uno por línea.
  • wave stats — conteos y duraciones desglosados por tipo y plataforma, opcionalmente entre --since y --until.

Compartir

  • wave shared list — sesiones que otros usuarios de Wave compartieron contigo, con --limit y --cursor.
  • wave shared get <owner_id> <session_id>, wave shared transcript, wave shared action-items y wave shared media — lee una. transcript acepta las mismas opciones --format y --speakers que wave transcript.
  • wave sessions list --include-shared — mezcla las sesiones compartidas en tu lista, cada una marcada con quién la compartió.
  • wave sessions share <id> — imprime un enlace de invitación. Agrega --email a@x.com,b@y.com (hasta 10) y un --message opcional para enviar invitaciones por correo en su lugar.
  • wave sessions access <id> — quién tiene acceso, además de las invitaciones por correo pendientes.
  • wave sessions unshare <id> con --recipient <user_id>, --email <address> o --everyone — elimina a una persona, cancela una invitación pendiente, o restablece el enlace y elimina a todos. wave sessions share reset <id> restablece el enlace; agrega --remove-everyone para quitar también el acceso de todos.

Las sesiones compartidas son de solo lectura, y wave search solo abarca las tuyas. Más información en Sharing Sessions from Claude, ChatGPT, the API and the CLI.

Carpetas

  • wave folders list — nombres, ids y cantidad de sesiones.
  • wave folders create "Customer research" --color "#6D28D9" — se puede ejecutar varias veces sin problema; un nombre coincidente devuelve la carpeta existente.

Para renombrar, cambiar el color o eliminar una carpeta, o para meterla dentro de otra como subcarpeta, usa la Developer API o la app de Wave.

Eventos y webhooks

  • wave events list --ack, wave events ack <cursor>, y wave events tail --interval 3 --ack --json — consume sesiones nuevas sin necesidad de alojar un receptor de webhooks. Wave recuerda tu posición por token.
  • wave webhooks list / create / update / test / rotate-secret / delete — gestiona la entrega push, incluyendo el envío de un evento de prueba y la rotación de un secreto de firma. create acepta --url y --events (session.completed, session.updated, session.deleted).

Configuración

wave config get, wave config set <key> <value> y wave config path gestionan api_key, api_url y default_format en el directorio de configuración de tu sistema operativo. wave config path imprime la ruta exacta del archivo, útil cuando quieres borrar las credenciales manualmente.

Un par de cosas que vale la pena automatizar con scripts

Respalda las grabaciones de la última semana, transcripción incluida:

wave sessions list --since 7d --limit 50 --json \
  | jq -r '.sessions[].id' \
  | xargs wave bulk --summary --transcript --json > backup.json

Vigila la llegada de sesiones nuevas y actúa sobre cada una en cuanto aparece:

wave events tail --interval 3 --ack --json

Los comandos se corresponden uno a uno con la Wave Developer API, así que todo lo que hace la CLI también puedes hacerlo desde tu propio código — y la CLI es una forma rápida de ver cómo luce una respuesta antes de escribir nada.

Preguntas frecuentes

¿Te resultó útil este artículo?

¿Necesitas más ayuda?

Escribir a soporte

En esta página