Wave CLI

Die Wave CLI holt deine Aufnahmen ins Terminal. Sie ist ein npm-Paket namens @waveai/cli, das einen wave-Befehl installiert, mit dem du Sessions auflisten, durchsuchen, ein Transkript ausgeben, Audio herunterladen oder alles davon in ein Skript weiterleiten kannst. Jeder Befehl, der Daten zurückgibt, akzeptiert --json, wodurch sich die CLI leicht mit anderen Tools kombinieren lässt.

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/cli

Um sie ohne Installation auszuprobieren:

npx @waveai/cli sessions list

Anmelden

Führe aus:

wave login

Dein Browser öffnet eine Authorize Wave CLI-Seite, die zeigt, mit welchem Konto du angemeldet bist und was die CLI damit tun darf. Klicke auf Authorize CLI, und die Seite bestätigt mit You can close this tab and return to your terminal. Das Terminal übernimmt daraufhin die Anmeldedaten und zeigt an, wie viele Sessions du hast.

Zwei weitere Möglichkeiten zur Authentifizierung:

• wave login --token wave_api_... — füge einen selbst erstellten Token ein. Geeignet für CI und Headless-Rechner.
• Setze eine Umgebungsvariable WAVE_API_KEY. Diese hat Vorrang vor dem, was wave login gespeichert hat, wodurch sich ein einzelner Befehl leicht mit einem anderen Konto ausführen lässt.

wave whoami zeigt Konto, Abo-Status und Anzahl der Sessions an. wave logout löscht die gespeicherten Anmeldedaten auf diesem Rechner.

Um einem Rechner, über den du keine Kontrolle mehr hast, den Zugriff zu entziehen, widerrufe den Token namens Wave CLI in der Wave-Web-App unter dem Tab Integrations, dann Developer API. Damit wird er überall deaktiviert, wo er verwendet wurde.

Die Befehle

Sessions

• wave sessions list — mit --limit, --since (akzeptiert 7d, 2w, 1m), --type, --folder, --tag (wiederholbar) und --tag-mode.
• wave sessions get <id> — Metadaten, Zusammenfassung, Notizen, Tags und Details zu Telefonanrufen für eine Session.
• wave sessions update <id> — setzt --title, --notes, --tags, --favorite / --no-favorite.
• wave sessions add-folder <session_id> <folder_id> und wave sessions remove-folder — Ordner sind nicht exklusiv, das Hinzufügen eines Ordners entfernt also keinen anderen.
• wave sessions action-items get <session_id> und wave sessions action-items update <session_id> — lies Aufgaben samt Version aus und schreibe sie anschließend aus einer Datei oder von stdin zurück, optional abgesichert mit --if-match, sodass eine gleichzeitige Bearbeitung in der App abgelehnt statt überschrieben wird.
• wave sessions delete <id> — endgültig; die CLI fragt nach Bestätigung, außer du übergibst --force.

Inhalte

• wave search "your query" — semantische Suche, mit Filtern über --limit und --tag.
• wave transcript <id> — gibt ein Transkript aus. --format akzeptiert text (Standard), srt oder segments; --speakers wechselt zur sprecherbeschrifteten Ausgabe, und --json liefert die Rohantwort.
• wave media urls <id> — signierte Audio- und Video-URLs.
• wave media download <id> — speichert die Audiodatei; füge --video für MP4 hinzu oder --output für einen bestimmten Pfad.
• wave bulk [ids...] — exportiert bis zu 50 Sessions auf einmal, mit --summary und --transcript.
• wave stats — Anzahl und Dauer, aufgeschlüsselt nach Typ und Plattform.

Ordner

• wave folders list — Namen, IDs und Anzahl der Sessions.
• wave folders create "Customer research" --color "#6D28D9" — kann sicher erneut ausgeführt werden; bei übereinstimmendem Namen wird der vorhandene Ordner zurückgegeben.

Ereignisse und Webhooks

• wave events list --ack, wave events ack <cursor> und wave events tail --interval 3 --ack --json — neue Sessions abrufen, ohne einen Webhook-Receiver zu hosten. Wave merkt sich deine Position pro Token.
• wave webhooks list / create / update / test / rotate-secret / delete — verwalte Push-Zustellungen, einschließlich Senden eines Testereignisses und Rotieren eines Signing-Secrets.

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 – praktisch, wenn du Anmeldedaten manuell löschen willst.

Ein paar Dinge, die sich zum Skripten lohnen

Die letzte Woche an Aufnahmen inklusive Transkript sichern:

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

Auf neue Sessions warten und bei jeder einzelnen sofort reagieren:

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

FAQ