Wave CLI

Le Wave CLI met vos enregistrements dans le terminal. C'est un package npm appelé @waveai/cli qui installe une commande wave, vous permettant de lister vos sessions, de les rechercher, d'afficher une transcription, de télécharger l'audio, ou d'envoyer tout ça dans un script via un pipe. Chaque commande qui renvoie des données accepte --json, ce qui facilite la composition avec d'autres outils.

C'est gratuit sur tous les forfaits Wave, et ça nécessite Node.js 20 ou une version plus récente. Ça fonctionne sur macOS, Linux et Windows.

Installation

npm install -g @waveai/cli

Pour l'essayer sans rien installer :

npx @waveai/cli sessions list

Connexion

Exécutez :

wave login

Votre navigateur ouvre une page Authorize Wave CLI ("Autoriser Wave CLI") indiquant le compte avec lequel vous êtes connecté et ce que le CLI pourra faire. Cliquez sur Authorize CLI, et la page confirme avec You can close this tab and return to your terminal. ("Vous pouvez fermer cet onglet et revenir à votre terminal."). Le terminal récupère alors l'identifiant et indique le nombre de sessions dont vous disposez.

Deux autres façons de vous authentifier :

• wave login --token wave_api_... — collez un jeton que vous avez créé vous-même. Pratique pour la CI et les machines sans interface graphique.
• Définissez une variable d'environnement WAVE_API_KEY. Elle est prioritaire sur ce que wave login a stocké, ce qui permet facilement d'exécuter une commande avec un autre compte.

wave whoami affiche le compte, l'état de l'abonnement et le nombre de sessions. wave logout efface l'identifiant stocké sur cette machine.

Pour couper l'accès à une machine que vous ne contrôlez plus, révoquez le jeton nommé Wave CLI dans l'application web Wave, sous l'onglet Integrations, puis Developer API. Cela le désactive partout où il était utilisé.

Les commandes

Sessions

• wave sessions list — avec --limit, --since (accepte 7d, 2w, 1m), --type, --folder, --tag (répétable), et --tag-mode.
• wave sessions get <id> — métadonnées, résumé, notes, tags et détails d'appel téléphonique pour une session.
• wave sessions update <id> — définissez --title, --notes, --tags, --favorite / --no-favorite.
• wave sessions add-folder <session_id> <folder_id> et wave sessions remove-folder — les dossiers ne sont pas exclusifs, donc en ajouter un ne retire pas les autres.
• wave sessions action-items get <session_id> et wave sessions action-items update <session_id> — lisez les actions à mener avec leur version, puis réécrivez-les à partir d'un fichier ou de l'entrée standard, en option protégé par --if-match pour qu'une modification simultanée dans l'application soit rejetée plutôt qu'écrasée.
• wave sessions delete <id> — définitif, et une confirmation est demandée sauf si vous passez --force.

Contenu

• wave search "votre requête" — recherche sémantique, avec filtres --limit et --tag.
• wave transcript <id> — affiche une transcription. --format accepte text (par défaut), srt, ou segments ; --speakers bascule vers une sortie avec identification des intervenants, et --json renvoie la réponse brute.
• wave media urls <id> — URLs signées pour l'audio et la vidéo.
• wave media download <id> — enregistre l'audio ; ajoutez --video pour un MP4 ou --output pour un chemin spécifique.
• wave bulk [ids...] — exporte jusqu'à 50 sessions à la fois, avec --summary et --transcript.
• wave stats — nombres et durées répartis par type et plateforme.

Partage

• wave shared list — sessions que d'autres utilisateurs de Wave ont partagées avec vous, avec --limit et --cursor.
• wave shared get <owner_id> <session_id>, wave shared transcript, wave shared action-items, et wave shared media — pour lire une session partagée. transcript accepte les mêmes options --format et --speakers que wave transcript.
• wave sessions list --include-shared — intègre les sessions partagées à votre liste, chacune indiquant qui l'a partagée.
• wave sessions share <id> — affiche un lien d'invitation. Ajoutez --email a@x.com,b@y.com (jusqu'à 10) et un --message optionnel pour envoyer les invitations par e-mail à la place.
• wave sessions access <id> — qui a accès, plus les invitations par e-mail en attente.
• wave sessions unshare <id> avec --recipient <user_id>, --email <address>, ou --everyone — retire une personne, annule une invitation en attente, ou réinitialise le lien et retire l'accès à tout le monde. wave sessions share reset <id> réinitialise le lien ; ajoutez --remove-everyone pour aussi retirer l'accès de tout le monde.

Les sessions partagées sont en lecture seule, et wave search ne couvre que vos propres sessions. Plus de détails dans Partager des sessions depuis Claude, ChatGPT, l'API et le CLI.

Dossiers

• wave folders list — noms, identifiants et nombre de sessions.
• wave folders create "Customer research" --color "#6D28D9" — peut être relancé sans risque ; un nom correspondant renvoie le dossier existant.

Événements et webhooks

• wave events list --ack, wave events ack <cursor>, et wave events tail --interval 3 --ack --json — récupérez les nouvelles sessions sans avoir à héberger un récepteur de webhook. Wave se souvient de votre position pour chaque jeton.
• wave webhooks list / create / update / test / rotate-secret / delete — gérez la livraison push, y compris l'envoi d'un événement de test et la rotation d'un secret de signature.

Configuration

wave config get, wave config set <key> <value>, et wave config path gèrent api_key, api_url, et default_format dans le répertoire de configuration de votre système. wave config path affiche le fichier exact, ce qui est pratique quand vous voulez effacer manuellement les identifiants.

Quelques idées de scripts utiles

Sauvegarder les enregistrements de la dernière semaine, transcription incluse :

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

Surveiller les nouvelles sessions et réagir à chacune dès son arrivée :

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

FAQ