Plaud CLI - Plaud Dev API

Voraussetzungen

Node.js ≥ 20 — Herunterladen
Ein Plaud-Konto

Installieren

npm install -g @plaud-ai/cli

Schnellstart

plaud login          # über den Browser anmelden
plaud files          # Ihre Aufnahmen durchsuchen
plaud search "Q2"    # eine Aufnahme über ein Schlüsselwort finden
plaud summary <id>   # die KI-Zusammenfassung lesen
plaud transcript <id> # das vollständige Transkript lesen

Befehlsreferenz

Authentifizierung

plaud login    # über den Browser anmelden – Tokens werden automatisch gespeichert
plaud logout   # abmelden und Autorisierung widerrufen
plaud me       # Ihre aktuellen Kontodaten anzeigen

Durchsuchen

plaud files                   # letzte Seite der Aufnahmen
plaud files --page 2 --page-size 50
plaud recent                  # Aufnahmen der letzten 7 Tage
plaud recent --days 30        # Aufnahmen der letzten 30 Tage
plaud today                   # nur Aufnahmen von heute

plaud filesOptionen

Option	Beschreibung	Standard
`-p, --page`	Seitenzahl (1–1000)	`1`
`-s, --page-size`	Elemente pro Seite (10–100)	`20`

Suchen

plaud search <keyword>
plaud search "weekly" --from 2026-04-01 --to 2026-04-30
plaud search "onboarding" --max 10

Client-seitige Schlüsselwortsuche (Groß-/Kleinschreibung wird nicht berücksichtigt) im Namen der Aufnahmen. Durchsucht die bis zu 500 letzten Aufnahmen.

Option	Beschreibung
`--from <YYYY-MM-DD>`	Beginn des Datumsbereichs (einschließlich)
`--to <YYYY-MM-DD>`	Ende des Datumsbereichs (einschließlich)
`--max <n>`	Maximale Ergebnisse zur Anzeige (Standard: `50`)

Eine Aufnahme anzeigen

plaud file <id>               # vollständige Metadaten und Verfügbarkeit
plaud audio <id>              # 24-Stunden-URL zum Herunterladen der Audiodatei
plaud transcript <id>         # Transkript mit Zeitstempel
plaud transcript <id> -o transcript.txt   # in Datei speichern
plaud summary <id>            # KI-Zusammenfassung (Markdown)
plaud summary <id> -o summary.md          # in Datei speichern

Dienstprogramm

plaud version    # installierte Version und Build-Informationen anzeigen
plaud update     # nach einer neueren Version suchen und den Aktualisierungsbefehl ausgeben

Datenreferenz

Felder in `plaud files` / `plaud file`

Feld	Beschreibung
`id`	Eindeutige Aufnahme-ID — verwenden Sie diese in anderen Befehlen
`name`	Aufnahmename
`created_at`	Erstellungszeit (ISO 8601)
`duration`	Länge der Aufnahme

Zusätzliche Felder nur in plaud file <id>:

Feld	Beschreibung
`start_at`	Aufnahmestartzeit (ISO 8601)
`serial_number`	Geräte-Seriennummer
`audio`	Ob Audio zum Herunterladen verfügbar ist
`transcript`	Ob ein Transkript verfügbar ist
`summary`	Ob eine KI-Zusammenfassung verfügbar ist

Exit-Codes

Code	Bedeutung
`0`	Erfolg
`1`	Ungültige Argumente oder unbekannter Fehler
`2`	Authentifizierung fehlgeschlagen — führen Sie `plaud login` aus
`3`	Netzwerkfehler — überprüfen Sie Ihre Verbindung
`4`	Die Anforderung hat eine Zeitüberschreitung

Alle Fehler werden in stderr geschrieben, während stdout für Piping und Skripting bereinigt bleibt:

✖ [AUTH_FAILED] Token ungültig oder abgelaufen. Führen Sie `plaud login` aus.

Konfiguration

Tokens werden unter ~/.plaud/tokens.json gespeichert und automatisch verwaltet — keine manuellen Änderungen erforderlich. Für die erweiterte Nutzung erstellen Sie eine optionale Konfigurationsdatei unter ~/.plaud/cli.yaml:

api_base: "https://platform.plaud.ai/developer/api"
timeout: 30000   # Millisekunden

Umgebungsvariablen überschreiben sowohl die Konfigurationsdatei als auch die integrierten Standardwerte:

Variable	Zweck
`PLAUD_API_BASE`	Überschreiben Sie die API-Basis-URL
`PLAUD_CLIENT_ID` / `PLAUD_CLI_CLIENT_ID`	OAuth-Client-ID
`PLAUD_CLIENT_SECRET`	OAuth-Client-Geheimnis
`PLAUD_AUTH_URL`	Autorisierungsendpunkt
`PLAUD_TOKEN_URL`	Token-Austauschendpunkt
`PLAUD_REFRESH_URL`	Token-Aktualisierungsendpunkt

Upgrade

npm install -g @plaud-ai/cli@latest

Oder zuerst überprüfen:

plaud update

Deinstallieren

npm uninstall -g @plaud-ai/cli
rm -rf ~/.plaud

Fehlersuche

Symptom	Behebung
`401` / „Nicht authentifiziert“	Führen Sie `plaud login` aus
`plaud: command not found`	Öffnen Sie Ihr Terminal erneut; bestätigen Sie, dass `npm install -g @plaud-ai/cli` ohne Fehler abgeschlossen wurde
Token-Aktualisierungsfehler	Löschen Sie `~/.plaud/tokens.json` und führen Sie `plaud login` erneut aus
Browser wird während der Anmeldung nicht geöffnet	Kopieren Sie die im Terminal angezeigte URL und öffnen Sie sie manuell
`npx` gibt `E404` für `@plaud-ai/cli` zurück	Führen Sie `npm cache clean --force` aus und versuchen Sie es erneut

​Voraussetzungen

​Installieren

​Schnellstart

​Befehlsreferenz

​Authentifizierung

​Durchsuchen

​Suchen

​Eine Aufnahme anzeigen

​Dienstprogramm

​Datenreferenz

​Felder in plaud files / plaud file

​Exit-Codes

​Konfiguration

​Upgrade

​Deinstallieren

​Fehlersuche