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

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.