Plaud CLI - Plaud Dev API

Vereisten

Node.js ≥ 20 — downloaden
Een Plaud-account

Installatie

npm install -g @plaud-ai/cli

Snel aan de slag

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

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

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

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

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

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:

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

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

Of controleer eerst:

plaud update

Verwijderen

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

​Vereisten

​Installatie

​Snel aan de slag

​Opdrachtenoverzicht

​Authenticatie

​Bladeren

​Zoeken

​Een opname lezen

​Hulpprogramma’s

​Gegevensreferentie

​Velden in plaud files / plaud file

​Afsluitcodes

​Configuratie

​Upgraden

​Verwijderen

​Problemen oplossen