Wave CLI

Die Wave CLI holt deine Aufnahmen ins Terminal. Es handelt sich um ein npm-Paket namens @waveai/cli, das den Befehl wave installiert – damit kannst du Sessions auflisten, durchsuchen, ein Transkript ausgeben, Audio herunterladen oder alles davon in ein Skript einspeisen. Jeder Befehl, der Daten zurückgibt, akzeptiert --json, was das Zusammenspiel mit anderen Tools einfach macht.

Sie ist in jedem Wave-Plan kostenlos enthalten und benötigt Node.js 20 oder neuer. 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 Seite Authorize Wave CLI, 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 die Anmeldedaten und meldet, wie viele Sessions du hast.

Zwei weitere Möglichkeiten, dich zu authentifizieren:

• wave login --token wave_api_... – füge einen selbst erstellten Token ein. Gut für CI und headless-Maschinen.
• Setze eine Umgebungsvariable WAVE_API_KEY. Sie hat Vorrang vor allem, was wave login gespeichert hat, was es einfach macht, einen einzelnen Befehl unter einem anderen Konto auszuführen.

wave whoami zeigt Konto, Abo-Status und Anzahl der Sessions. wave logout löscht die gespeicherten Anmeldedaten von diesem Gerät.

Um einem Gerät, das du nicht mehr kontrollierst, den Zugriff zu entziehen, widerrufe den Token namens Wave CLI in der Wave-Web-App unter dem Tab Integrations, dann Developer API. Das deaktiviert ihn überall, 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 Anrufdetails 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 Action Items samt Version aus und schreibe sie dann aus einer Datei oder stdin zurück, optional abgesichert mit --if-match, damit eine gleichzeitige Bearbeitung in der App abgelehnt statt überschrieben wird.
• wave sessions delete <id> – endgültig, und fragt zur Bestätigung nach, außer du übergibst --force.

Inhalte

• wave search "deine Anfrage" – semantische Suche, mit den Filtern --limit und --tag.
• wave transcript <id> – gibt ein Transkript aus. --format akzeptiert text (Standard), srt oder segments; --speakers wechselt zu sprecherbeschrifteter Ausgabe, und --json liefert die Rohantwort.
• wave media urls <id> – signierte Audio- und Video-URLs.
• wave media download <id> – speichert das Audio; füge --video für MP4 oder --output für einen bestimmten Pfad hinzu.
• 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.

Teilen

• wave shared list – Sessions, die andere Wave-Nutzer mit dir geteilt haben, mit --limit und --cursor.
• wave shared get <owner_id> <session_id>, wave shared transcript, wave shared action-items und wave shared media – liest eine einzelne aus. transcript akzeptiert dieselben Flags --format und --speakers wie wave transcript.
• wave sessions list --include-shared – mischt geteilte Sessions in deine Liste, jeweils markiert mit der Person, die geteilt hat.
• wave sessions share <id> – gibt einen Einladungslink aus. Füge --email a@x.com,b@y.com (bis zu 10) und optional --message hinzu, 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, bricht eine ausstehende Einladung ab oder setzt den Link zurück und entfernt alle. wave sessions share reset <id> setzt den Link zurück; füge --remove-everyone hinzu, um auch den Zugriff aller zu entfernen.

Geteilte Sessions sind nur lesbar, und wave search durchsucht nur deine eigenen. Mehr dazu in Sharing Sessions from Claude, ChatGPT, the API and the CLI.

Ordner

• wave folders list – Namen, IDs und Session-Anzahl.
• wave folders create "Customer research" --color "#6D28D9" – kann gefahrlos erneut ausgeführt werden; ein passender Name gibt den vorhandenen Ordner zurück.

Events und Webhooks

• wave events list --ack, wave events ack <cursor> und wave events tail --interval 3 --ack --json – neue Sessions 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 Testereignis-Versand und Rotation 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 zeigt die genaue Datei an, praktisch, wenn du Anmeldedaten manuell löschst.

Ein paar Dinge, die sich zum Skripten lohnen

Sichere die Aufnahmen der letzten Woche samt Transkript:

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 reagieren, sobald sie eintrifft:

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

FAQ