Plaud

---
name: plaud
description: Export and download Plaud recordings (transcripts, summaries, audio) using the plaud CLI with safe auth handling.
---

# Plaud CLI skill

Use this skill when you need to authenticate to Plaud and export/download recordings from `app.plaud.ai` / `api.plaud.ai`.

## Hard constraints (security)

- Never print or paste a full Plaud auth token into chat/logs.
- Never pass tokens via CLI flags. Use `plaud auth login`, `plaud auth set --stdin`, or `PLAUD_AUTH_TOKEN`.
- Prefer `--json` outputs and keep stdout machine-readable where available.

## JSON contract

- For stable machine-readable behavior, follow `docs/CONTRACT_V1.md` (in this repo).

## Setup (once)

- If `plaud` isn’t installed globally, use `npx -y plaud ...` (slower but zero-setup).
- `plaud auth login`
- Verify: `plaud auth status --json` and `plaud doctor --json`

Fallbacks:
- `plaud auth import-har /path/to/web.plaud.ai.har`
- `plaud auth set --stdin`

## Common workflows

- List: `plaud recordings list --json --max 50`
- Get one: `plaud recordings get <id> --json`
- Download one: `plaud recordings download <id> --out ./plaud-download --what transcript,summary,json`
- Download audio: `plaud recordings download <id> --out ./plaud-download --what audio --audio-format opus`
- Bulk export: `plaud recordings export --zip`
- Trash: `plaud recordings trash <id>`
- Restore: `plaud recordings restore <id>`
- Tags (list): `plaud recordings tags list --json`
- Tags (add): `plaud recordings tags add <tagId> <id>`
- Tags (clear): `plaud recordings tags clear <id>`
- Re-run transcript/summary: `plaud recordings rerun <id> --wait`
- Recording speaker labels (list): `plaud recordings speakers list <id> --json`
- Recording speaker labels (rename): `plaud recordings speakers rename <id> --from "Speaker 2" --to "Yash Patel"`

## Notes

- `plaud recordings export` prints a JSON summary to stdout; progress goes to stderr.
- When in doubt: run `plaud doctor --json` to confirm auth + API access.