Wave CLI
Installeer de wave-opdracht, log in via je browser en bekijk, doorzoek, exporteer en organiseer je opnames vanuit de terminal.
Laatst bijgewerkt:
De Wave CLI brengt je opnames naar de terminal. Het is een npm-pakket genaamd @waveai/cli dat een wave-opdracht installeert, zodat je sessies kunt weergeven, doorzoeken, een transcript kunt afdrukken, audio kunt downloaden, of alles kunt doorsluizen naar een script. Elke opdracht die data teruggeeft, accepteert --json, zodat je het makkelijk met andere tools kunt combineren.
De CLI is gratis op elk Wave-abonnement en vereist Node.js 20 of nieuwer. Hij werkt op macOS, Linux en Windows.
Installeren
npm install -g @waveai/cliOm het zonder installatie uit te proberen:
npx @waveai/cli sessions listInloggen
Voer uit:
wave loginJe browser opent een pagina Authorize Wave CLI die laat zien met welk account je bent ingelogd en wat de CLI kan doen. Klik op Authorize Wave CLI, waarna de pagina bevestigt met Wave CLI is authorized ("Wave CLI is geautoriseerd") — You can close this tab and go back to your terminal. ("Je kunt dit tabblad sluiten en teruggaan naar je terminal.") De terminal pikt de inloggegevens op en meldt hoeveel sessies je hebt.
Als je op deze manier inlogt, wordt er een API-token aangemaakt met de naam Wave CLI met alle API-rechten — inclusief het permanent verwijderen van sessies en het delen ervan — ook al toont de autorisatiepagina minder rechten. Wil je iets beperkters, sla dan de browserflow over: maak een token aan met alleen de rechten die je nodig hebt op de pagina Developer API en voer in plaats daarvan wave login --token wave_api_... uit.
Er zijn nog 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_KEYin. Deze heeft voorrang op watwave loginheeft opgeslagen, waardoor je makkelijk één opdracht als een ander account kunt uitvoeren.
wave whoami toont het account, de abonnementsstatus en het aantal sessies. wave logout wist de opgeslagen inloggegevens van deze machine.
Om de toegang van een machine die je niet meer onder controle hebt af te snijden, trek je het token met de naam Wave CLI in in de Wave-webapp onder Settings → Developers → API tokens and webhooks. Dat maakt het overal ongeldig waar het werd gebruikt.
De opdrachten
Sessions
wave sessions list— met--limit(tot 100),--cursor,--since(accepteert7d,2w,1m),--type,--folder(id of naam),--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-favoritein.wave sessions add-folder <session_id> <folder_id>enwave sessions remove-folder— mappen sluiten elkaar niet uit, dus het toevoegen van de ene verwijdert de andere niet.wave sessions action-items get <session_id>enwave sessions action-items update <session_id>— lees actiepunten inclusief hun versie, en schrijf ze vervolgens terug vanuit stdin of--from-file, optioneel beveiligd met--if-matchzodat een gelijktijdige bewerking in de app wordt geweigerd in plaats van overschreven.wave sessions delete <id>— permanent, en vraagt om bevestiging tenzij je--forcemeegeeft.
Content
wave search "jouw zoekopdracht"— semantisch zoeken, met--limit(tot 50),--tagen--tag-mode.wave transcript <id>— druk een transcript af.--formataccepteerttext(standaard),srtofsegments;--speakersschakelt over naar output met sprekerslabels, en--jsongeeft de ruwe response terug.wave media urls <id>— ondertekende audio- en video-URL's.wave media download <id>— slaat de audio op; voeg--videotoe voor MP4 of--outputvoor een specifiek pad.wave bulk [ids...]— exporteer tot 50 sessies tegelijk, met--summaryen--transcript.--fileleest de id's uit een bestand, één per regel.wave stats— aantallen en duur uitgesplitst per type en platform, optioneel tussen--sinceen--until.
Sharing
wave shared list— sessies die andere Wave-gebruikers met jou hebben gedeeld, met--limiten--cursor.wave shared get <owner_id> <session_id>,wave shared transcript,wave shared action-itemsenwave shared media— lees er één.transcriptaccepteert dezelfde--format- en--speakers-vlaggen alswave transcript.wave sessions list --include-shared— neem gedeelde sessies op in je lijst, elk gemarkeerd met wie hem heeft gedeeld.wave sessions share <id>— drukt een uitnodigingslink af. Voeg--email a@x.com,b@y.comtoe (tot 10) en optioneel een--messageom in plaats daarvan uitnodigingen per e-mail te sturen.wave sessions access <id>— wie er 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-everyonetoe om ook de toegang van iedereen weg te halen.
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.
Folders
wave folders list— namen, id's en aantallen sessies.wave folders create "Customer research" --color "#6D28D9"— veilig om opnieuw uit te voeren; bij een overeenkomende naam krijg je de bestaande map terug.
Om een map te hernoemen, een andere kleur te geven, te verwijderen of als submap in een andere map te zetten, gebruik je de Developer API of de Wave-app.
Events and webhooks
wave events list --ack,wave events ack <cursor>enwave events tail --interval 3 --ack --json— verwerk nieuwe sessies zonder zelf een webhook-ontvanger te hoeven hosten. Wave onthoudt je positie per token.wave webhooks list / create / update / test / rotate-secret / delete— beheer push-bezorging, inclusief het verzenden van een testevent en het roteren van een ondertekeningsgeheim.createaccepteert--urlen--events(session.completed,session.updated,session.deleted).
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 toont het exacte bestand, handig als je handmatig inloggegevens 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.jsonHoud nieuwe sessies in de gaten en reageer op elke sessie zodra die binnenkomt:
wave events tail --interval 3 --ack --jsonDe opdrachten komen één-op-één overeen met de Wave Developer API, dus alles wat de CLI doet, kun je ook vanuit je eigen code doen — en de CLI is een snelle manier om te zien hoe een response eruitziet voordat je zelf iets schrijft.
FAQ
api.wave.co/cli toont elke opdracht met voorbeelden, en wave --help (of --help bij een willekeurige subopdracht) toont hetzelfde lokaal. Het pakket zelf staat op npmjs.com/package/@waveai/cli.
Het inlogproces geeft het na ongeveer een minuut op. Zorg dat je het afrondt in het browserprofiel waarin je bij Wave bent ingelogd, en voer dan wave login opnieuw uit. Op een machine zonder browser gebruik je wave login --token wave_api_....
API-tokens verlopen een jaar na aanmaak. Voer wave login opnieuw uit om een nieuw token aan te maken.
Ja — stel WAVE_API_KEY in voor die ene opdracht. Dat overschrijft de opgeslagen inloggegevens tijdelijk, zonder ze te wijzigen.
Was dit artikel nuttig?
Nog hulp nodig?
Sessies delen vanuit Claude, ChatGPT, de API en de CLI
Lees sessies die anderen met je hebben gedeeld, en deel je eigen sessies, vanuit een AI-assistent, je eigen code of de terminal.
Wave automatiseren met Zapier
Stuur elke afgeronde sessie — samenvatting, transcript, titel en link — direct door naar 8.000+ apps zodra Wave ermee klaar is, zonder code.