> ## 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 > Accédez à vos enregistrements Plaud depuis le terminal : parcourez, recherchez, lisez les transcriptions, téléchargez l'audio et consultez les résumés IA sans ouvrir l'application. ## Prérequis * Node.js ≥ 20 — [Télécharger](https://nodejs.org/) * Compte Plaud *** ## Installer ```bash theme={"system"} npm install -g @plaud-ai/cli ``` *** ## Démarrage rapide ```bash theme={"system"} plaud login # connectez-vous via le navigateur plaud files # parcourez vos enregistrements plaud search "Q2" # trouvez un enregistrement par mot-clé plaud summary # lisez le résumé IA plaud transcript # lisez la transcription complète ``` *** ## Référence de commande ### Authentification ```bash theme={"system"} 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 ```bash theme={"system"} 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 ```bash theme={"system"} plaud search 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 ` | Début de la plage de dates (inclus) | | `--to ` | Fin de la plage de dates (inclus) | | `--max ` | Nombre maximum de résultats à afficher (par défaut : `50`) | ### Lire un enregistrement ```bash theme={"system"} plaud file # métadonnées complètes et disponibilité plaud audio # URL de téléchargement de 24 heures pour l'audio plaud transcript # transcription horodatée plaud transcript -o transcript.txt # enregistrez dans un fichier plaud summary # résumé IA (Markdown) plaud summary -o summary.md # enregistrez dans un fichier ``` ### Utilitaire ```bash theme={"system"} 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 ` 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` : ```yaml theme={"system"} 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 ```bash theme={"system"} npm install -g @plaud-ai/cli@latest ``` Ou vérifier d'abord : ```bash theme={"system"} plaud update ``` *** ## Désinstaller ```bash theme={"system"} 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 |