> ## 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. # CLI de Plaud > Accede a tus grabaciones de Plaud desde la terminal: navega, busca, lee transcripciones, descarga audio y visualiza resúmenes hechos con IA sin abrir la aplicación. ## Requisitos previos * Node.js ≥ 20 — [descargar](https://nodejs.org/) * Una cuenta de Plaud *** ## Instalar ```bash theme={"system"} npm install -g @plaud-ai/cli ``` *** ## Inicio rápido ```bash theme={"system"} plaud login # inicia sesión a través del navegador plaud files # explora tus grabaciones plaud search "Q2" # encuentra grabaciones por palabras clave plaud summary # lee el resumen de IA plaud transcript # lee la transcripción completa ``` *** ## Referencia de comandos ### Autenticación ```bash theme={"system"} plaud login # inicia sesión a través del navegador; los tokens se guardan automáticamente plaud logout # cierra sesión y revoca la autorización plaud me # muestra los detalles de tu cuenta actual ``` ### Navegar ```bash theme={"system"} plaud files # última página de grabaciones plaud files --page 2 --page-size 50 plaud recent # grabaciones de los últimos 7 días plaud recent --days 30 # grabaciones de los últimos 30 días plaud today # grabaciones solo de hoy ``` **`plaud files` (opciones)** | Opción | Descripción | Valor predeterminado | | ----------------- | ----------------------------- | -------------------- | | `-p, --page` | Número de página (1–1000) | `1` | | `-s, --page-size` | Elementos por página (10–100) | `20` | ### Buscar ```bash theme={"system"} plaud search plaud search "weekly" --from 2026-04-01 --to 2026-04-30 plaud search "onboarding" --max 10 ``` Búsqueda de palabras clave del lado del cliente (sin distinción entre mayúsculas y minúsculas) en los nombres de las grabaciones. Escanea hasta las 500 grabaciones más recientes. | Opción | Descripción | | --------------------- | ----------------------------------------------------- | | `--from ` | Inicio del intervalo de fechas (inclusive) | | `--to ` | Fin del intervalo de fechas (inclusive) | | `--max ` | Máximo de resultados a mostrar (predeterminado: `50`) | ### Leer una grabación ```bash theme={"system"} plaud file # metadatos completos y disponibilidad plaud audio # URL de descarga de audio válida durante 24 horas plaud transcript # transcripción con marcas de tiempo plaud transcript -o transcript.txt # guardar en archivo plaud summary # resumen de IA (Markdown) plaud summary -o summary.md # guardar en archivo ``` ### Utilidad ```bash theme={"system"} plaud version # muestra la versión instalada e información de compilación plaud update # verifica si hay una versión más nueva e imprime el comando de actualización ``` *** ## Referencia de datos ### Campos en `plaud files` / `plaud file` | Campo | Descripción | | ------------ | ---------------------------------------------- | | `id` | ID de grabación único: úsalo en otros comandos | | `name` | Nombre de la grabación | | `created_at` | Hora de creación (ISO 8601) | | `duration` | Duración de la grabación | Campos adicionales solo en `plaud file `: | Campo | Descripción | | --------------- | ------------------------------------------ | | `start_at` | Hora de inicio de la grabación (ISO 8601) | | `serial_number` | Número de serie del dispositivo | | `audio` | Si el audio está disponible para descargar | | `transcript` | Si hay una transcripción disponible | | `summary` | Si hay un resumen de IA disponible | ### Códigos de salida | Código | Significado | | ------ | --------------------------------------------- | | `0` | Éxito | | `1` | Argumentos inválidos o error desconocido | | `2` | Error de autenticación; ejecuta `plaud login` | | `3` | Error de red; verifica la conexión | | `4` | La solicitud ha superado el tiempo de espera | Todos los errores se escriben en **stderr**, manteniendo stdout limpio para piping y scripting: ``` ✖ [AUTH_FAILED] Token inválido o caducado. Ejecuta `plaud login`. ``` *** ## Configuración Los tokens se almacenan en `~/.plaud/tokens.json` y se gestionan automáticamente; no es necesario realizar cambios manuales. Para uso avanzado, crea un archivo de configuración opcional en `~/.plaud/cli.yaml`: ```yaml theme={"system"} api_base: "https://platform.plaud.ai/developer/api" timeout: 30000 # milisegundos ``` Las variables de entorno anulan tanto el archivo de configuración como los valores predeterminados incorporados: | Variable | Finalidad | | ----------------------------------------- | -------------------------------------- | | `PLAUD_API_BASE` | Sobrescribir la URL base de la API | | `PLAUD_CLIENT_ID` / `PLAUD_CLI_CLIENT_ID` | ID de cliente de OAuth | | `PLAUD_CLIENT_SECRET` | Secreto de cliente de OAuth | | `PLAUD_AUTH_URL` | Punto final de autorización | | `PLAUD_TOKEN_URL` | Punto final de intercambio de tokens | | `PLAUD_REFRESH_URL` | Punto final de actualización de tokens | *** ## Actualizar ```bash theme={"system"} npm install -g @plaud-ai/cli@latest ``` O primero comprueba lo siguiente: ```bash theme={"system"} plaud update ``` *** ## Desinstalar ```bash theme={"system"} npm uninstall -g @plaud-ai/cli rm -rf ~/.plaud ``` *** ## Resolución de problemas | Síntoma | Solución | | --------------------------------------------------- | -------------------------------------------------------------------------------------------- | | `401` / "No autenticado" | Ejecuta `plaud login` | | `plaud: command not found` | Reabre la terminal; confirma que `npm install -g @plaud-ai/cli` se ha completado sin errores | | Errores de actualización de tokens | Elimina `~/.plaud/tokens.json` y ejecuta `plaud login` nuevamente | | El navegador no se abre durante el inicio de sesión | Copia la URL impresa en la terminal y ábrela manualmente | | `npx` devuelve `E404` para `@plaud-ai/cli` | Ejecuta `npm cache clean --force` e inténtalo de nuevo |