Help Center

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/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 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, was wave login gespeichert 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 (akzeptiert 7d, 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> und wave 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> und wave sessions action-items update <session_id> — lies Action Items samt ihrer Version aus und schreibe sie anschließend aus stdin oder --from-file 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 es wird eine Bestätigung verlangt, sofern du nicht --force übergibst.

Inhalte

  • wave search "your query" — semantische Suche, mit --limit (bis zu 50), --tag und --tag-mode.
  • 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 Sitzungen auf einmal, mit --summary und --transcript. --file liest die IDs aus einer Datei, eine pro Zeile.
  • wave stats — Anzahl und Dauer aufgeschlüsselt nach Typ und Plattform, optional zwischen --since und --until.

Teilen

  • wave shared list — Sitzungen, 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 Sitzung. transcript akzeptiert dieselben Flags --format und --speakers wie wave 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 --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, 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-everyone hinzu, 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> und wave 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. create akzeptiert --url und --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.json

Auf neue Sitzungen achten und bei jeder sofort reagieren:

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

Die 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

War dieser Artikel hilfreich?

Brauchst du noch Hilfe?

Support per E-Mail

Auf dieser Seite