Wave CLI

Met de Wave CLI beheer je je opnames vanuit 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 data teruggeeft accepteert --json, wat het makkelijk maakt om te combineren met andere tools.

Het is gratis bij 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 zonder installatie uit te proberen:

npx @waveai/cli sessions list

Inloggen

Voer uit:

wave login

Je browser opent een pagina Authorize Wave CLI ("Wave CLI autoriseren") die laat zien met welk account je bent ingelogd en wat de CLI zal kunnen doen. Klik op Authorize CLI, en de pagina bevestigt dit met You can close this tab and return to your terminal. De terminal herkent de inloggegevens 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 omgevingsvariabele WAVE_API_KEY in. Deze heeft voorrang op wat wave login heeft opgeslagen, wat het makkelijk maakt om één commando als een ander account uit te voeren.

wave whoami toont het account, de abonnementsstatus en het aantal sessies. wave logout wist 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 op onder het tabblad Integrations in de Wave-webapp, en dan Developer API. Dat maakt het overal waar het werd gebruikt ongeldig.

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 telefoongesprekdetails 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 zijn niet exclusief, dus het toevoegen van de ene 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 er wordt om bevestiging gevraagd 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 response 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.

Delen

• wave shared list — sessies die andere Wave-gebruikers met jou hebben gedeeld, met --limit en --cursor.
• wave shared get <owner_id> <session_id>, wave shared transcript, wave shared action-items, en wave shared media — lees er één. transcript accepteert dezelfde vlaggen --format en --speakers als wave transcript.
• wave sessions list --include-shared — voeg gedeelde sessies toe aan je lijst, elk gemarkeerd met wie het heeft gedeeld.
• wave sessions share <id> — drukt een uitnodigingslink af. Voeg --email a@x.com,b@y.com toe (tot 10) en optioneel een --message om in plaats daarvan uitnodigingen per e-mail te versturen.
• wave sessions access <id> — wie toegang heeft, plus openstaande e-mailuitnodigingen.
• wave sessions unshare <id> met --recipient <user_id>, --email <address>, of --everyone — verwijder één persoon, annuleer een openstaande uitnodiging, of reset de link en verwijder iedereen. wave sessions share reset <id> reset de link; voeg --remove-everyone toe om ook ieders toegang in te trekken.

Gedeelde sessies zijn alleen-lezen, en wave search doorzoekt alleen je eigen sessies. Meer in Sharing Sessions from Claude, ChatGPT, the API and the CLI.

Mappen

• wave folders list — namen, ID's en aantal sessies.
• wave folders create "Customer research" --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 webhookontvanger te hosten. Wave onthoudt je positie per token.
• wave webhooks list / create / update / test / rotate-secret / delete — beheer push-bezorging, inclusief het versturen van een testevent en het roteren van een ondertekeningsgeheim.

Config

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 drukt het exacte bestand af, wat handig is als je inloggegevens handmatig wilt wissen.

Een paar dingen die het waard zijn om te scripten

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 reageer op elke sessie zodra die binnenkomt:

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

Veelgestelde vragen