Fluxomail CLI

npm i -g @fluxomail/sdk

# One‑shot (recommended for CI)
npx -y @fluxomail/sdk fluxomail --help
pnpm dlx @fluxomail/sdk fluxomail --help
bunx @fluxomail/sdk fluxomail --help

# Global
fluxomail send \
  --api-key $FLUXOMAIL_API_KEY \
  --to user@example.com \
  --subject "Hello" \
  --text "Hi there" \
  --idempotency tx-123

# Send with CC/BCC and attachment
fluxomail send \
  --api-key $FLUXOMAIL_API_KEY \
  --to user@example.com \
  --subject "Hello" \
  --text "Hi there" \
  --cc c1@example.com,c2@example.com \
  --bcc b1@example.com \
  --attach ./report.pdf:application/pdf:Q3-Report.pdf

fluxomail events list \
  --api-key $FLUXOMAIL_API_KEY \
  --types email.delivered,email.opened \
  --limit 50

fluxomail events tail \
  --api-key $FLUXOMAIL_API_KEY \
  --types email.*

# Resumable backfill with checkpoint
fluxomail events backfill \
  --api-key $FLUXOMAIL_API_KEY \
  --types email.* \
  --limit 100 \
  --checkpoint-file .fluxomail.ckpt

# Get a send's timeline
fluxomail timelines get \
  --api-key $FLUXOMAIL_API_KEY \
  --send-id send_abc123 \
  --limit 100

# Quick auth check
fluxomail whoami --api-key $FLUXOMAIL_API_KEY

# Scaffolds (creates directories as needed)
fluxomail init next ./my-next-app      # writes pages/api/fluxomail/token.ts
fluxomail init next-app ./my-next-app  # writes app/api/fluxomail/token/route.ts
fluxomail init worker ./my-worker      # writes worker.js

{
  "apiKey": "YOUR_API_KEY",
  "base": "https://api.fluxomail.com/api/v1",
  "version": "2025-09-01",
  "tokenCmd": "printf token-123"
}