pitch2pdf CLI

Install

npx pitch2pdf-cli https://pitch.com/v/your-deck

Or install globally:

npm install -g pitch2pdf-cli

Usage

pitch2pdf <url> [options]

Options:
  --email <email>        Email for protected presentations
  --password <password>  Password for protected presentations
  -o, --output <path>    Output file path (use - for stdout)
  --json                 Output NDJSON events to stdout
  --no-progress          Suppress progress output
  --api-url <url>        Custom API URL
  -V, --version          Show version
  -h, --help             Show help

Examples

pitch2pdf https://pitch.com/v/my-deck

pitch2pdf https://docsend.com/view/abc --email you@company.com

pitch2pdf https://docs.google.com/presentation/d/1abc/pub -o slides.pdf

pitch2pdf https://canva.com/design/abc/token/view -o - | wc -c

pitch2pdf https://pitch.com/v/deck --json
# Each line is a JSON object:
# {"status":"processing","stage":"loading","jobId":"abc123"}
# {"status":"processing","stage":"capturing","currentSlide":1,"totalSlides":10}
# {"status":"completed","jobId":"abc123","numSlides":10,...}
# {"event":"saved","path":"deck.pdf","size":2451623}

Exit Codes

Error Code Reference

Every failed conversion carries a code field — in --json output it's {"status":"failed","code":"...","message":"..."}, and it also determines the exit code above. This table covers what each one means, which services most commonly trigger it, and what to do about it.

Environment Variables

Free Tier

The CLI uses the free tier: first 10 slides at full resolution, remaining slides as preview thumbnails. For full deck with OCR-powered searchable text, upgrade at pitch2pdf.com.

Pay from an agent

An AI agent can buy the full deck without a person or a checkout page. Take the jobId from the --json output and call POST https://api.pitch2pdf.com/api/jobs/<jobId>/generate-paid; unpaid, the API answers 402 Payment Required with a payment challenge in the headers (x402 for USDC on Base, or Stripe's Machine Payments Protocol for a card via a Link agent wallet or USDC on Tempo). The agent pays the challenge — $3 per deck, the same as the one-time unlock — and retries the same request with the credential to receive the searchable PDF.

curl -N -X POST https://api.pitch2pdf.com/api/jobs/<jobId>/generate-paid \
  -H 'Content-Type: application/json' -d '{"size":"medium"}' \
  -H 'Authorization: Payment <credential>'     # or PAYMENT-SIGNATURE: … for x402

--pay is coming to the CLI; until then use the HTTP flow. The full contract, both rails, error codes and refunds are on the agents page.