> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plaud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plaud CLI

> Greifen Sie über das Terminal auf Ihre Plaud-Aufnahmen zu – durchsuchen, suchen, Transkripte lesen, Audio herunterladen und KI-Zusammenfassungen anzeigen, ohne die App zu öffnen.

## Voraussetzungen

* Node.js ≥ 20 — [Herunterladen](https://nodejs.org/)
* Ein Plaud-Konto

***

## Installieren

```bash theme={"system"}
npm install -g @plaud-ai/cli
```

***

## Schnellstart

```bash theme={"system"}
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

```bash theme={"system"}
plaud login    # über den Browser anmelden – Tokens werden automatisch gespeichert
plaud logout   # abmelden und Autorisierung widerrufen
plaud me       # Ihre aktuellen Kontodaten anzeigen
```

### Durchsuchen

```bash theme={"system"}
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 files`Optionen**

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

### Suchen

```bash theme={"system"}
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

```bash theme={"system"}
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

```bash theme={"system"}
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`:

```yaml theme={"system"}
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

```bash theme={"system"}
npm install -g @plaud-ai/cli@latest
```

Oder zuerst überprüfen:

```bash theme={"system"}
plaud update
```

***

## Deinstallieren

```bash theme={"system"}
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                                                |