Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (plaud) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

plaud

npm

Export all your Plaud recordings with speaker-labeled transcripts and optional AI summaries.

Disclaimer

This is an unofficial project (not affiliated with Plaud). It uses a captured Plaud bearer token and private web endpoints, so it may break if Plaud changes their web app.

Operational note: Plaud's private web API may reject non-browser request fingerprints at the edge even when the bearer token is valid. The CLI sends browser-like request headers, including a web user-agent, to match Plaud's web app requests.

Security note: do not share tokens or *.har files (HARs often contain Authorization headers).

Terminology

Plaud’s web UI uses “Files”. This CLI uses files as the primary command group, with recordings kept as an alias for compatibility: plaud files … (preferred) or plaud recordings ….

Install (npm)

Global (recommended for frequent use):

npm i -g plaud
plaud auth login

No install (convenient for agents/one-offs):

npx -y plaud auth status --json

Install (skill)

npx -y skills add -g danielgwilson/plaud --skill plaud

Publishing (maintainers)

This repo is configured for npm trusted publishing from GitHub Actions.

Workflow: .github/workflows/publish.yml
npm Trusted Publisher workflow filename: publish.yml

Install (local)

cd plaud/plaud-cli
npm install
npm link

Requirements:

Node.js 22+ (tested on Node 24)

Auth

Preferred (easy onboarding, stores token locally):

plaud auth login

Verify:

plaud auth status
plaud doctor

Fallbacks:

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

Or via env var (no local storage):

export PLAUD_AUTH_TOKEN="eyJ..."

Tip (Node 22+): you can also use Node’s --env-file if you want to load a local .env without adding any dependency to the CLI:

node --env-file .env "$(command -v plaud)" auth status --json

Export

Create a single ZIP (default):

plaud files export --zip

Export to a directory:

plaud files export --out ./plaud-transcripts --formats txt,json,md

Download a single recording

plaud files list --json --limit 10
plaud files download <id> --out ./plaud-download --what transcript,summary,json
plaud files download <id> --out ./plaud-download --what audio --audio-format opus

Notes:

plaud files export prints a JSON summary to stdout; progress goes to stderr.
(plaud recordings … is supported as an alias for plaud files ….)
Tokens are stored at ~/.config/plaud/config.json with 0600 permissions.

Agent-first JSON contract

See docs/CONTRACT_V1.md.