> ## 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

> Open je Plaud-opnames rechtstreeks vanuit de terminal — blader, zoek, lees transcripties, download audio en bekijk AI-samenvattingen zonder de app te openen.

## Vereisten

* Node.js ≥ 20 — [downloaden](https://nodejs.org/)
* Een Plaud-account

***

## Installatie

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

***

## Snel aan de slag

```bash theme={"system"}
plaud login          # meld je aan via de browser
plaud files          # blader door je opnames
plaud search "Q2"    # zoek een opname op trefwoord
plaud summary <id>   # lees de AI-samenvatting
plaud transcript <id> # lees de volledige transcriptie
```

***

## Opdrachtenoverzicht

### Authenticatie

```bash theme={"system"}
plaud login    # meld je aan via de browser — tokens worden automatisch opgeslagen
plaud logout   # meld je af en trek de autorisatie in
plaud me       # bekijk je huidige accountgegevens
```

### Bladeren

```bash theme={"system"}
plaud files                   # laatste pagina met opnames
plaud files --page 2 --page-size 50
plaud recent                  # opnames van de afgelopen 7 dagen
plaud recent --days 30        # opnames van de afgelopen 30 dagen
plaud today                   # alleen opnames van vandaag
```

**`plaud files` opties**

| Optie             | Beschrijving              | Standaard |
| ----------------- | ------------------------- | --------- |
| `-p, --page`      | Paginanummer (1–1000)     | `1`       |
| `-s, --page-size` | Items per pagina (10–100) | `20`      |

### Zoeken

```bash theme={"system"}
plaud search <keyword>
plaud search "weekly" --from 2026-04-01 --to 2026-04-30
plaud search "onboarding" --max 10
```

Zoeken op trefwoorden in opnamenamen aan de clientzijde (niet hoofdlettergevoelig). Doorzoekt maximaal de 500 meest recente opnamen.

| Optie                 | Beschrijving                                              |
| --------------------- | --------------------------------------------------------- |
| `--from <YYYY-MM-DD>` | Begin van het datumbereik (inclusief)                     |
| `--to <YYYY-MM-DD>`   | Einde van het datumbereik (inclusief)                     |
| `--max <n>`           | Maximum aantal weer te geven resultaten (standaard: `50`) |

### Een opname lezen

```bash theme={"system"}
plaud file <id>               # volledige metadata en beschikbaarheid
plaud audio <id>              # 24-uurs download-URL voor de audio
plaud transcript <id>         # transcriptie met tijdstempels
plaud transcript <id> -o transcript.txt   # opslaan in bestand
plaud summary <id>            # AI-samenvatting (Markdown)
plaud summary <id> -o summary.md          # opslaan in bestand
```

### Hulpprogramma's

```bash theme={"system"}
plaud version    # toon de geïnstalleerde versie en buildinformatie
plaud update     # controleer of er een nieuwere versie beschikbaar is en geef de upgradeopdracht weer
```

***

## Gegevensreferentie

### Velden in `plaud files` / `plaud file`

| Veld         | Beschrijving                                        |
| ------------ | --------------------------------------------------- |
| `id`         | Unieke opname-ID — gebruik dit in andere opdrachten |
| `name`       | Naam van de opname                                  |
| `created_at` | Aanmaaktijd (ISO 8601)                              |
| `duration`   | Lengte van de opname                                |

Extra velden alleen beschikbaar in `plaud file <id>`:

| Veld            | Beschrijving                                       |
| --------------- | -------------------------------------------------- |
| `start_at`      | Starttijd van de opname (ISO 8601)                 |
| `serial_number` | Serienummer van het apparaat                       |
| `audio`         | Geeft aan of audio beschikbaar is om te downloaden |
| `transcript`    | Geeft aan of een transcriptie beschikbaar is       |
| `summary`       | Geeft aan of een AI-samenvatting beschikbaar is    |

### Afsluitcodes

| Code | Betekenis                                      |
| ---- | ---------------------------------------------- |
| `0`  | Succes                                         |
| `1`  | Ongeldige argumenten of onbekende fout         |
| `2`  | Authenticatie mislukt — voer `plaud login` uit |
| `3`  | Netwerkfout — controleer uw verbinding         |
| `4`  | Time-out van de aanvraag                       |

Alle fouten worden naar **stderr** geschreven, zodat stdout schoon blijft voor piping en scripting:

```
✖ [AUTH_FAILED] Token ongeldig of verlopen. Voer `plaud login` uit.
```

***

## Configuratie

Tokens worden opgeslagen in `~/.plaud/tokens.json` en automatisch beheerd — handmatige wijzigingen zijn niet nodig.

Voor geavanceerd gebruik kunt u een optioneel configuratiebestand aanmaken in `~/.plaud/cli.yaml`:

```yaml theme={"system"}
api_base: "https://platform.plaud.ai/developer/api"
timeout: 30000   # milliseconden
```

Omgevingsvariabelen overschrijven zowel het configuratiebestand als de ingebouwde standaardwaarden:

| Variabele                                 | Doel                        |
| ----------------------------------------- | --------------------------- |
| `PLAUD_API_BASE`                          | API-basis-URL overschrijven |
| `PLAUD_CLIENT_ID` / `PLAUD_CLI_CLIENT_ID` | OAuth-client-ID             |
| `PLAUD_CLIENT_SECRET`                     | OAuth-clientgeheim          |
| `PLAUD_AUTH_URL`                          | Autorisatie-eindpunt        |
| `PLAUD_TOKEN_URL`                         | Token-uitwisselingseindpunt |
| `PLAUD_REFRESH_URL`                       | Token-verversingseindpunt   |

***

## Upgraden

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

Of controleer eerst:

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

***

## Verwijderen

```bash theme={"system"}
npm uninstall -g @plaud-ai/cli
rm -rf ~/.plaud
```

***

## Problemen oplossen

| Probleem                                     | Oplossing                                                                                          |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `401` / "Niet geauthenticeerd"               | Voer `plaud login` uit                                                                             |
| `plaud: command not found`                   | Open de terminal opnieuw en controleer of `npm install -g @plaud-ai/cli` zonder fouten is voltooid |
| Fouten bij vernieuwen van token              | Verwijder `~/.plaud/tokens.json` en voer `plaud login` opnieuw uit                                 |
| Browser wordt niet geopend tijdens aanmelden | Kopieer de URL die in de terminal wordt weergegeven en open deze handmatig                         |
| `npx`retourneert `E404` voor `@plaud-ai/cli` | Voer `npm cache clean --force` uit en probeer het opnieuw                                          |