Awesome-omni-skill plaud

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

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/cli-automation/plaud" ~/.claude/skills/diegosouzapw-awesome-omni-skill-plaud && rm -rf "$T"
manifest: skills/cli-automation/plaud/SKILL.md
source content

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.