Help Center

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/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 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 que wave login a 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 (accepte 7d, 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> 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 depuis stdin ou --from-file, en option protégé par --if-match pour 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), --tag et --tag-mode.
  • wave transcript <id> — affiche une transcription. --format accepte text (par défaut), srt, ou segments ; --speakers bascule vers un affichage avec les intervenants identifiés, 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 en une fois, avec --summary et --transcript. --file lit 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 --since et --until.

Partage

  • wave shared list — sessions que d'autres utilisateurs 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 — 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 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-everyone pour 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>, et wave 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. create accepte --url et --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.json

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

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

Les 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

Cet article vous a-t-il été utile ?

Besoin d'aide supplémentaire ?

Écrire au support

Sur cette page