Plaud CLI - Plaud Dev API

Prérequis

Node.js ≥ 20 — Télécharger
Compte Plaud

Installer

npm install -g @plaud-ai/cli

Démarrage rapide

plaud login          # connectez-vous via le navigateur
plaud files          # parcourez vos enregistrements
plaud search "Q2"    # trouvez un enregistrement par mot-clé
plaud summary <id>   # lisez le résumé IA
plaud transcript <id> # lisez la transcription complète

Référence de commande

Authentification

plaud login    # connectez-vous via le navigateur — les jetons sont enregistrés automatiquement
plaud logout   # déconnectez-vous et révoquez l'autorisation
plaud me       # affichez les détails de votre compte actuel

Parcourir

plaud files                   # dernière page des enregistrements
plaud files --page 2 --page-size 50
plaud recent                  # enregistrements des 7 derniers jours
plaud recent --days 30        # enregistrements des 30 derniers jours
plaud today                   # enregistrements d'aujourd'hui uniquement

plaud files options

Option	Description	Par défaut
`-p, --page`	Numéro de page (1–1000)	`1`
`-s, --page-size`	Éléments par page (10–100)	`20`

Recherche

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

Recherche de mots-clés côté client (insensible à la casse) sur les noms des enregistrements. Analyse jusqu’à 500 enregistrements les plus récents.

Option	Description
`--from <YYYY-MM-DD>`	Début de la plage de dates (inclus)
`--to <YYYY-MM-DD>`	Fin de la plage de dates (inclus)
`--max <n>`	Nombre maximum de résultats à afficher (par défaut : `50`)

Lire un enregistrement

plaud file <id>               # métadonnées complètes et disponibilité
plaud audio <id>              # URL de téléchargement de 24 heures pour l'audio
plaud transcript <id>         # transcription horodatée
plaud transcript <id> -o transcript.txt   # enregistrez dans un fichier
plaud summary <id>            # résumé IA (Markdown)
plaud summary <id> -o summary.md          # enregistrez dans un fichier

Utilitaire

plaud version    # affichez la version installée et les informations de niveau
plaud update     # vérifiez s'il existe une version plus récente et affichez la commande de mise à niveau

Référence des données

Champs dans `plaud files` / `plaud file`

Champ	Description
`id`	ID d’enregistrement unique — utilisez-le dans d’autres commandes
`name`	Nom de l’enregistrement
`created_at`	Date et heure de création (ISO 8601)
`duration`	Durée de l’enregistrement

Champs supplémentaires dans plaud file <id> uniquement :

Champ	Description
`start_at`	Date et heure de début de l’enregistrement (ISO 8601)
`serial_number`	Numéro de série de l’appareil
`audio`	Indique si l’audio est disponible en téléchargement
`transcript`	Indique si la transcription est disponible
`summary`	Indique si le résumé IA est disponible

Codes de sortie

Code	Signification
`0`	Succès
`1`	Arguments invalides ou erreur inconnue
`2`	Échec de l’authentification — exécutez `plaud login`
`3`	Erreur réseau — vérifiez votre connexion
`4`	Délai d’attente de la requête

Toutes les erreurs sont écrites dans stderr, ce qui laisse stdout propre pour le piping et le scripting :

✖ [AUTH_FAILED] Jeton invalide ou expiré. Exécutez `plaud login`.

Configuration

Les jetons sont stockés à ~/.plaud/tokens.json et gérés automatiquement — aucune modification manuelle nécessaire. Pour un usage avancé, veuillez créer un fichier de configuration optionnel à ~/.plaud/cli.yaml :

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

Les variables d’environnement remplacent à la fois le fichier de configuration et les valeurs par défaut intégrées :

Variable	But
`PLAUD_API_BASE`	Veuillez remplacer l’URL de base de l’API
`PLAUD_CLIENT_ID` / `PLAUD_CLI_CLIENT_ID`	Identifiant client OAuth
`PLAUD_CLIENT_SECRET`	Secret client OAuth
`PLAUD_AUTH_URL`	Point de terminaison d’autorisation
`PLAUD_TOKEN_URL`	Point de terminaison d’échange de jetons
`PLAUD_REFRESH_URL`	Point de terminaison de rafraîchissement de jetons

Mettre à niveau

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

Ou vérifier d’abord :

plaud update

Désinstaller

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

Dépannage

Symptôme	Correction
`401` / « Non authentifié »	Exécutez `plaud login`
`plaud: command not found`	Rouvrez votre terminal ; confirmez que `npm install -g @plaud-ai/cli` s’est terminé sans erreurs
Erreurs de rafraîchissement des jetons	Supprimez `~/.plaud/tokens.json` et exécutez à nouveau `plaud login`
Le navigateur ne s’ouvre pas pendant la connexion	Copiez l’URL affichée dans le terminal et ouvrez-la manuellement
`npx` renvoie `E404` pour `@plaud-ai/cli`	Exécutez `npm cache clean --force` et réessayez

​Prérequis

​Installer

​Démarrage rapide

​Référence de commande

​Authentification

​Parcourir

​Recherche

​Lire un enregistrement

​Utilitaire

​Référence des données

​Champs dans plaud files / plaud file

​Codes de sortie

​Configuration

​Mettre à niveau

​Désinstaller

​Dépannage