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/cliPara probarlo sin instalar nada:
npx @waveai/cli sessions listInicia sesión
Ejecuta:
wave loginTu 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 guardadowave 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(acepta7d,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>ywave sessions remove-folder— las carpetas no son excluyentes, así que agregar una no elimina otra.wave sessions action-items get <session_id>ywave 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-matchpara 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),--tagy--tag-mode.wave transcript <id>— imprime una transcripción.--formataceptatext(el valor predeterminado),srtosegments;--speakerscambia a una salida con los hablantes identificados, y--jsondevuelve la respuesta sin procesar.wave media urls <id>— URLs firmadas de audio y video.wave media download <id>— guarda el audio; agrega--videopara obtener MP4 o--outputpara especificar una ruta.wave bulk [ids...]— exporta hasta 50 sesiones a la vez, con--summaryy--transcript.--filelee los ids desde un archivo, uno por línea.wave stats— conteos y duraciones desglosados por tipo y plataforma, opcionalmente entre--sincey--until.
Compartir
wave shared list— sesiones que otros usuarios de Wave compartieron contigo, con--limity--cursor.wave shared get <owner_id> <session_id>,wave shared transcript,wave shared action-itemsywave shared media— lee una.transcriptacepta las mismas opciones--formaty--speakersquewave 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--messageopcional 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-everyonepara 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>, ywave 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.createacepta--urly--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.jsonVigila la llegada de sesiones nuevas y actúa sobre cada una en cuanto aparece:
wave events tail --interval 3 --ack --jsonLos 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
api.wave.co/cli enumera todos los comandos con ejemplos, y wave --help (o --help en cualquier subcomando) imprime lo mismo localmente. El paquete en sí está en npmjs.com/package/@waveai/cli.
El inicio de sesión se cancela después de aproximadamente un minuto. Asegúrate de completarlo en el perfil del navegador donde tienes la sesión de Wave iniciada, y luego ejecuta wave login de nuevo. En una máquina sin navegador, usa wave login --token wave_api_....
Los tokens de API expiran un año después de haber sido creados. Ejecuta wave login de nuevo para generar uno nuevo.
Sí — define WAVE_API_KEY para ese comando en particular. Esto anula la credencial guardada sin modificarla.
¿Te resultó útil este artículo?
¿Necesitas más ayuda?
Compartir sesiones desde Claude, ChatGPT, la API y la CLI
Lee las sesiones que otras personas comparten contigo y comparte las tuyas, desde un asistente de IA, tu propio código o la terminal.
Automatiza Wave con Zapier
Envía cada sesión terminada —resumen, transcripción, título y enlace— a más de 8000 apps en el momento en que Wave la termina, sin necesidad de código.