Wave CLI
Installez la commande wave, connectez-vous depuis votre navigateur, puis listez, recherchez, exportez et organisez vos enregistrements depuis le terminal.
Dernière mise à jour:
La Wave CLI met vos enregistrements dans le terminal. Il s'agit d'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 de rediriger n'importe lequel de ces résultats vers un script. Chaque commande qui renvoie des données accepte --json, ce qui facilite la composition avec d'autres outils.
Elle est gratuite sur tous les plans Wave et nécessite Node.js 20 ou une version plus récente. Elle fonctionne sous macOS, Linux et Windows.
Installation
npm install -g @waveai/cliPour l'essayer sans rien installer :
npx @waveai/cli sessions listConnexion
Exécutez :
wave loginVotre navigateur ouvre une page Authorize Wave CLI ("Autoriser Wave CLI") indiquant le compte avec lequel vous êtes connecté et ce que la CLI pourra faire. Cliquez sur Authorize Wave CLI, et la page confirme avec Wave CLI is authorized ("Wave CLI est autorisée") — You can close this tab and go back to your terminal. ("Vous pouvez fermer cet onglet et retourner à votre terminal.") Le terminal récupère l'identifiant et indique combien de sessions vous avez.
Se connecter de cette façon crée un jeton API nommé Wave CLI avec toutes les permissions de l'API — y compris la suppression définitive de sessions et leur partage — même si la page d'autorisation en liste moins. Si vous souhaitez quelque chose de plus restreint, évitez le flux du navigateur : créez un jeton avec uniquement les permissions dont vous avez besoin sur la page Developer API et exécutez plutôt wave login --token wave_api_....
Deux autres façons de s'authentifier :
wave login --token wave_api_...— collez un jeton que vous avez créé vous-même. Pratique pour le CI et les machines sans interface graphique.- Définissez une variable d'environnement
WAVE_API_KEY. Elle est prioritaire sur ce quewave logina enregistré, ce qui permet facilement d'exécuter une commande sous 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 Settings → Developers → API tokens and webhooks ("Paramètres → Développeurs → Jetons API et webhooks"). Cela le désactive partout où il a été utilisé.
Les commandes
Sessions
wave sessions list— avec--limit(jusqu'à 100),--cursor,--since(accepte7d,2w,1m),--type,--folder(id ou nom),--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éfinit--title,--notes,--tags,--favorite/--no-favorite.wave sessions add-folder <session_id> <folder_id>etwave 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>etwave sessions action-items update <session_id>— lisez les actions à mener avec leur version, puis réécrivez-les depuis stdin ou--from-file, en option protégé par--if-matchpour qu'une modification concurrente dans l'application soit rejetée plutôt qu'écrasée.wave sessions delete <id>— définitif, et demande confirmation sauf si vous passez--force.
Contenu
wave search "votre requête"— recherche sémantique, avec--limit(jusqu'à 50),--taget--tag-mode.wave transcript <id>— affiche une transcription.--formatacceptetext(par défaut),srt, ousegments;--speakersbascule vers un affichage avec les intervenants identifiés, et--jsonrenvoie 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--videopour un MP4 ou--outputpour un chemin spécifique.wave bulk [ids...]— exporte jusqu'à 50 sessions en une fois, avec--summaryet--transcript.--filelit les ids depuis un fichier, un par ligne.wave stats— nombre et durée des sessions réparties par type et par plateforme, éventuellement entre--sinceet--until.
Partage
wave shared list— sessions que d'autres utilisateurs Wave ont partagées avec vous, avec--limitet--cursor.wave shared get <owner_id> <session_id>,wave shared transcript,wave shared action-items, etwave shared media— lire une session partagée.transcriptaccepte les mêmes options--formatet--speakersquewave 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--messageoptionnel pour envoyer des 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 tout le monde.wave sessions share reset <id>réinitialise le lien ; ajoutez--remove-everyonepour retirer aussi l'accès de tout le monde.
Les sessions partagées sont en lecture seule, et wave search ne couvre que vos propres sessions. Pour en savoir plus : Sharing Sessions from Claude, ChatGPT, the API and the CLI.
Dossiers
wave folders list— noms, ids et nombre de sessions.wave folders create "Customer research" --color "#6D28D9"— peut être relancée sans risque ; un nom correspondant renvoie le dossier existant.
Pour renommer, recolorer ou supprimer un dossier, ou pour le placer dans un autre dossier comme sous-dossier, utilisez la Developer API ou l'application Wave.
Événements et webhooks
wave events list --ack,wave events ack <cursor>, etwave events tail --interval 3 --ack --json— récupérez les nouvelles sessions sans héberger de récepteur de webhook. Wave mémorise votre position par jeton.wave webhooks list / create / update / test / rotate-secret / delete— gérez la diffusion push, y compris l'envoi d'un événement de test et la rotation d'un secret de signature.createaccepte--urlet--events(session.completed,session.updated,session.deleted).
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, pratique quand vous effacez des identifiants à la main.
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.jsonSurveiller les nouvelles sessions et agir sur chacune dès son arrivée :
wave events tail --interval 3 --ack --jsonLes commandes correspondent une à une à la Wave Developer API, donc tout ce que fait la CLI, vous pouvez aussi le faire depuis votre propre code — et la CLI est un moyen rapide de voir à quoi ressemble une réponse avant d'en écrire une.
FAQ
api.wave.co/cli liste toutes les commandes avec des exemples, et wave --help (ou --help sur n'importe quelle sous-commande) affiche la même chose localement. Le package lui-même se trouve sur npmjs.com/package/@waveai/cli.
La connexion expire au bout d'environ une minute. Assurez-vous de la finaliser dans le profil de navigateur où vous êtes connecté à Wave, puis relancez wave login. Sur une machine sans navigateur, utilisez wave login --token wave_api_....
Les jetons API expirent un an après leur création. Relancez wave login pour en générer un nouveau.
Oui — définissez WAVE_API_KEY pour cette commande précise. Cela remplace l'identifiant stocké sans le modifier.
Cet article vous a-t-il été utile ?
Besoin d'aide supplémentaire ?
Partager des sessions depuis Claude, ChatGPT, l'API et la CLI
Lisez les sessions que d'autres personnes ont partagées avec vous, et partagez les vôtres, depuis un assistant IA, votre propre code, ou le terminal.
Automatiser Wave avec Zapier
Envoyez chaque session terminée — résumé, transcription, titre et lien — vers plus de 8 000 applications dès que Wave a fini de la traiter, sans code.