Wave CLI
Installiere den wave-Befehl, melde dich über deinen Browser an und liste, durchsuche, exportiere und organisiere deine Aufnahmen vom Terminal aus.
Zuletzt aktualisiert:
Die Wave CLI bringt deine Aufnahmen ins Terminal. Es handelt sich um ein npm-Paket namens @waveai/cli, das einen wave-Befehl installiert, mit dem du Sitzungen auflisten, durchsuchen, ein Transkript ausgeben, Audio herunterladen oder all das in ein Skript einspeisen kannst. Jeder Befehl, der Daten zurückgibt, akzeptiert --json, was die Kombination mit anderen Tools erleichtert.
Sie ist in jedem Wave-Plan kostenlos enthalten und benötigt Node.js 20 oder neuer. Sie läuft unter macOS, Linux und Windows.
Installation
npm install -g @waveai/cliUm sie ohne Installation auszuprobieren:
npx @waveai/cli sessions listAnmelden
Führe aus:
wave loginDein Browser öffnet eine Seite Authorize Wave CLI, die anzeigt, mit welchem Konto du angemeldet bist und was die CLI können wird. Klicke auf Authorize Wave CLI, und die Seite bestätigt mit Wave CLI is authorized ("Wave CLI ist autorisiert") — You can close this tab and go back to your terminal. ("Du kannst diesen Tab schließen und zu deinem Terminal zurückkehren.") Das Terminal übernimmt die Anmeldedaten und zeigt an, wie viele Sitzungen du hast.
Wenn du dich auf diese Weise anmeldest, wird ein API-Token namens Wave CLI mit sämtlichen API-Berechtigungen erstellt – einschließlich des endgültigen Löschens und Teilens von Sitzungen –, auch wenn die Autorisierungsseite weniger Berechtigungen auflistet. Wenn du etwas Eingeschränkteres möchtest, überspringe den Browser-Flow: Erstelle auf der Seite Developer API ein Token nur mit den benötigten Berechtigungen und führe stattdessen wave login --token wave_api_... aus.
Zwei weitere Möglichkeiten, dich zu authentifizieren:
wave login --token wave_api_...— füge ein selbst erstelltes Token ein. Gut geeignet für CI und Headless-Rechner.- Setze eine Umgebungsvariable
WAVE_API_KEY. Sie hat Vorrang vor dem, waswave logingespeichert hat, wodurch es einfach wird, einen einzelnen Befehl unter einem anderen Konto auszuführen.
wave whoami zeigt das Konto, den Abo-Status und die Anzahl der Sitzungen. wave logout entfernt die gespeicherten Anmeldedaten von diesem Rechner.
Um einen Rechner abzuschneiden, über den du keine Kontrolle mehr hast, widerrufe das Token namens Wave CLI in der Wave-Web-App unter Settings → Developers → API tokens and webhooks ("Einstellungen → Entwickler → API-Tokens und Webhooks"). Damit wird es überall deaktiviert, wo es verwendet wurde.
Die Befehle
Sessions
wave sessions list— mit--limit(bis zu 100),--cursor,--since(akzeptiert7d,2w,1m),--type,--folder(ID oder Name),--tag(wiederholbar) und--tag-mode.wave sessions get <id>— Metadaten, Zusammenfassung, Notizen, Tags und Anruf-Details für eine Sitzung.wave sessions update <id>— setzt--title,--notes,--tags,--favorite/--no-favorite.wave sessions add-folder <session_id> <folder_id>undwave sessions remove-folder— Ordner schließen sich nicht gegenseitig aus, daher entfernt das Hinzufügen eines Ordners keinen anderen.wave sessions action-items get <session_id>undwave sessions action-items update <session_id>— lies Action Items samt ihrer Version aus und schreibe sie anschließend aus stdin oder--from-filezurück, optional abgesichert mit--if-match, damit eine gleichzeitige Bearbeitung in der App abgelehnt statt überschrieben wird.wave sessions delete <id>— endgültig, und es wird eine Bestätigung verlangt, sofern du nicht--forceübergibst.
Inhalte
wave search "your query"— semantische Suche, mit--limit(bis zu 50),--tagund--tag-mode.wave transcript <id>— gibt ein Transkript aus.--formatakzeptierttext(Standard),srtodersegments;--speakerswechselt zu sprecherbeschrifteter Ausgabe, und--jsonliefert die Rohantwort.wave media urls <id>— signierte Audio- und Video-URLs.wave media download <id>— speichert das Audio; füge--videofür MP4 oder--outputfür einen bestimmten Pfad hinzu.wave bulk [ids...]— exportiert bis zu 50 Sitzungen auf einmal, mit--summaryund--transcript.--fileliest die IDs aus einer Datei, eine pro Zeile.wave stats— Anzahl und Dauer aufgeschlüsselt nach Typ und Plattform, optional zwischen--sinceund--until.
Teilen
wave shared list— Sitzungen, die andere Wave-Nutzer mit dir geteilt haben, mit--limitund--cursor.wave shared get <owner_id> <session_id>,wave shared transcript,wave shared action-itemsundwave shared media— liest eine Sitzung.transcriptakzeptiert dieselben Flags--formatund--speakerswiewave transcript.wave sessions list --include-shared— mischt geteilte Sitzungen in deine Liste, jeweils mit Angabe, wer sie geteilt hat.wave sessions share <id>— gibt einen Einladungslink aus. Füge--email a@x.com,b@y.com(bis zu 10) und optional--messagehinzu, um stattdessen Einladungen per E-Mail zu versenden.wave sessions access <id>— wer Zugriff hat, plus ausstehende E-Mail-Einladungen.wave sessions unshare <id>mit--recipient <user_id>,--email <address>oder--everyone— entfernt eine Person, storniert eine ausstehende Einladung oder setzt den Link zurück und entzieht allen den Zugriff.wave sessions share reset <id>setzt den Link zurück; füge--remove-everyonehinzu, um auch allen den Zugriff zu entziehen.
Geteilte Sitzungen sind schreibgeschützt, und wave search durchsucht nur deine eigenen Sitzungen. Mehr dazu in Sharing Sessions from Claude, ChatGPT, the API and the CLI.
Ordner
wave folders list— Namen, IDs und Anzahl der Sitzungen.wave folders create "Customer research" --color "#6D28D9"— kann gefahrlos erneut ausgeführt werden; ein übereinstimmender Name gibt den vorhandenen Ordner zurück.
Um einen Ordner umzubenennen, seine Farbe zu ändern, ihn zu löschen oder ihn als Unterordner in einen anderen Ordner zu legen, nutze die Developer API oder die Wave-App.
Events und Webhooks
wave events list --ack,wave events ack <cursor>undwave events tail --interval 3 --ack --json— neue Sitzungen abrufen, ohne einen Webhook-Empfänger zu hosten. Wave merkt sich deine Position pro Token.wave webhooks list / create / update / test / rotate-secret / delete— verwaltet die Push-Zustellung, einschließlich Senden eines Testereignisses und Rotieren eines Signierschlüssels.createakzeptiert--urlund--events(session.completed,session.updated,session.deleted).
Konfiguration
wave config get, wave config set <key> <value> und wave config path verwalten api_key, api_url und default_format im Konfigurationsverzeichnis deines Betriebssystems. wave config path gibt die genaue Datei aus, was praktisch ist, wenn du Anmeldedaten manuell löschen willst.
Ein paar Dinge, die sich fürs Skripten lohnen
Sichere die Aufnahmen der letzten Woche, Transkript inklusive:
wave sessions list --since 7d --limit 50 --json \
| jq -r '.sessions[].id' \
| xargs wave bulk --summary --transcript --json > backup.jsonAuf neue Sitzungen achten und bei jeder sofort reagieren:
wave events tail --interval 3 --ack --jsonDie Befehle bilden eins zu eins die Wave Developer API ab, sodass alles, was die CLI macht, auch aus deinem eigenen Code heraus möglich ist — und die CLI ist eine schnelle Möglichkeit zu sehen, wie eine Antwort aussieht, bevor du selbst Code schreibst.
FAQ
api.wave.co/cli listet jeden Befehl mit Beispielen auf, und wave --help (oder --help bei einem beliebigen Unterbefehl) gibt lokal dasselbe aus. Das Paket selbst findest du unter npmjs.com/package/@waveai/cli.
Die Anmeldung bricht nach etwa einer Minute ab. Stelle sicher, dass du sie in dem Browserprofil abschließt, in dem du bei Wave angemeldet bist, und führe dann wave login erneut aus. Auf einem Rechner ohne Browser nutze wave login --token wave_api_....
API-Tokens laufen ein Jahr nach ihrer Erstellung ab. Führe wave login erneut aus, um ein neues zu erzeugen.
Ja — setze WAVE_API_KEY für diesen einen Befehl. Das überschreibt die gespeicherten Anmeldedaten, ohne sie zu verändern.
War dieser Artikel hilfreich?
Brauchst du noch Hilfe?
Sitzungen aus Claude, ChatGPT, der API und der CLI teilen
Lies die Sitzungen, die andere mit dir geteilt haben, und teile deine eigenen – aus einem KI-Assistenten, deinem eigenen Code oder dem Terminal.
Wave mit Zapier automatisieren
Schicke jede abgeschlossene Aufnahme – Zusammenfassung, Transkript, Titel und Link – in dem Moment, in dem Wave fertig ist, ohne Code an über 8.000 Apps.