Wave CLI

De Wave CLI brengt je opnames naar de terminal. Het is een npm-pakket genaamd @waveai/cli dat een wave-commando installeert, waarmee je sessies kunt weergeven, doorzoeken, een transcript kunt afdrukken, audio kunt downloaden, of alles kunt doorsluizen naar een script. Elk commando dat gegevens teruggeeft accepteert --json, waardoor het makkelijk te combineren is met andere tools.

Het is gratis op elk Wave-abonnement en vereist Node.js 20 of nieuwer. Het werkt op macOS, Linux en Windows.

Installeren

npm install -g @waveai/cli

Om het uit te proberen zonder iets te installeren:

npx @waveai/cli sessions list

Inloggen

Voer uit:

wave login

Je browser opent een Authorize Wave CLI-pagina die laat zien met welk account je bent ingelogd en wat de CLI kan doen. Klik op Authorize CLI, waarna de pagina bevestigt met You can close this tab and return to your terminal. ("Je kunt dit tabblad sluiten en terugkeren naar je terminal.") De terminal pikt de inloggegevens op en meldt hoeveel sessies je hebt.

Twee andere manieren om in te loggen:

• wave login --token wave_api_... — plak een token dat je zelf hebt aangemaakt. Handig voor CI en headless machines.
• Stel een WAVE_API_KEY-omgevingsvariabele in. Deze heeft voorrang op wat wave login heeft opgeslagen, waardoor je makkelijk één commando als een ander account kunt uitvoeren.

wave whoami toont het account, de abonnementsstatus en het aantal sessies. wave logout verwijdert de opgeslagen inloggegevens van deze machine.

Om een machine waar je geen controle meer over hebt af te sluiten, trek je het token met de naam Wave CLI in de Wave-webapp in, onder het tabblad Integrations, dan Developer API. Dat maakt het overal ongeldig waar het werd gebruikt.

De commando's

Sessies

• wave sessions list — met --limit, --since (accepteert 7d, 2w, 1m), --type, --folder, --tag (herhaalbaar) en --tag-mode.
• wave sessions get <id> — metadata, samenvatting, notities, tags en gespreksdetails voor één sessie.
• wave sessions update <id> — stel --title, --notes, --tags, --favorite / --no-favorite in.
• wave sessions add-folder <session_id> <folder_id> en wave sessions remove-folder — mappen sluiten elkaar niet uit, dus het toevoegen van één map verwijdert een andere niet.
• wave sessions action-items get <session_id> en wave sessions action-items update <session_id> — lees actiepunten met hun versie, en schrijf ze terug vanuit een bestand of stdin, optioneel beveiligd met --if-match zodat een gelijktijdige bewerking in de app wordt geweigerd in plaats van overschreven.
• wave sessions delete <id> — permanent, en vraagt om bevestiging tenzij je --force meegeeft.

Inhoud

• wave search "je zoekopdracht" — semantisch zoeken, met filters --limit en --tag.
• wave transcript <id> — druk een transcript af. --format accepteert text (standaard), srt of segments; --speakers schakelt over naar output met sprekerlabels, en --json geeft de ruwe respons terug.
• wave media urls <id> — ondertekende audio- en video-URL's.
• wave media download <id> — slaat de audio op; voeg --video toe voor MP4 of --output voor een specifiek pad.
• wave bulk [ids...] — exporteer tot 50 sessies tegelijk, met --summary en --transcript.
• wave stats — aantallen en duur, uitgesplitst per type en platform.

Mappen

• wave folders list — namen, id's en aantal sessies.
• wave folders create "Klantonderzoek" --color "#6D28D9" — veilig om opnieuw uit te voeren; een overeenkomende naam geeft de bestaande map terug.

Events en webhooks

• wave events list --ack, wave events ack <cursor> en wave events tail --interval 3 --ack --json — verwerk nieuwe sessies zonder een webhook-ontvanger te hoeven hosten. Wave onthoudt je positie per token.
• wave webhooks list / create / update / test / rotate-secret / delete — beheer push-levering, inclusief het versturen van een testevent en het roteren van een ondertekeningsgeheim.

Configuratie

wave config get, wave config set <key> <value> en wave config path beheren api_key, api_url en default_format in de configuratiemap van je besturingssysteem. wave config path toont het exacte bestand, wat handig is als je inloggegevens handmatig wilt wissen.

Een paar dingen die het scripten waard zijn

Maak een back-up van de opnames van de afgelopen week, inclusief transcript:

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

Houd nieuwe sessies in de gaten en handel bij elke sessie zodra die binnenkomt:

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

Veelgestelde vragen