CLI de Plaud - Plaud Dev API

Requisitos previos

Node.js ≥ 20 — descargar
Una cuenta de Plaud

Instalar

npm install -g @plaud-ai/cli

Inicio rápido

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 <id>   # lee el resumen de IA
plaud transcript <id> # lee la transcripción completa

Referencia de comandos

Autenticación

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

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

plaud search <keyword>
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 <YYYY-MM-DD>`	Inicio del intervalo de fechas (inclusive)
`--to <YYYY-MM-DD>`	Fin del intervalo de fechas (inclusive)
`--max <n>`	Máximo de resultados a mostrar (predeterminado: `50`)

Leer una grabación

plaud file <id>               # metadatos completos y disponibilidad
plaud audio <id>              # URL de descarga de audio válida durante 24 horas
plaud transcript <id>         # transcripción con marcas de tiempo
plaud transcript <id> -o transcript.txt   # guardar en archivo
plaud summary <id>            # resumen de IA (Markdown)
plaud summary <id> -o summary.md          # guardar en archivo

Utilidad

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 <id>:

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:

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

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

O primero comprueba lo siguiente:

plaud update

Desinstalar

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

​Requisitos previos

​Instalar

​Inicio rápido

​Referencia de comandos

​Autenticación

​Navegar

​Buscar

​Leer una grabación

​Utilidad

​Referencia de datos

​Campos en plaud files / plaud file

​Códigos de salida

​Configuración

​Actualizar

​Desinstalar

​Resolución de problemas