pp-resend

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/resend/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Resend — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `resend-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install resend --cli-only
   ```
2. Verify: `resend-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/productivity/resend/cmd/resend-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## When to Use This CLI

Use this CLI when an agent needs to answer cross-resource questions about a Resend account that the dashboard or SDK cannot answer in one call — what did we send to a specific recipient, which audiences is a contact in, how does broadcast performance trend over time, what's the 7-day bounce rate. Stick with `npx resend send` for one-shot transactional sends or with React Email for templates; this CLI is the agent-facing companion, not a replacement.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Cross-resource queries over local state
- **`emails to`** — Every email sent to a single recipient address, with delivery status and timestamps, ordered newest-first.

  _Reach for this when an agent needs to reconstruct what a single user has received — support tickets, GDPR exports, dispute investigations._

  ```bash
  resend-pp-cli emails to <your-email> --json --select id,subject,status,sent_at
  ```
- **`emails timeline`** — Collapsed event chain for a single email: sent → delivered → opened → clicked → bounced, in one ordered table.

  _Use when debugging 'why didn't this arrive?' — one command shows whether it was sent, delivered, opened, or bounced and when._

  ```bash
  resend-pp-cli emails timeline 4ef9a417-d4ff-4ec5-9af2-c80a4d5d2c1f --json
  ```
- **`audiences inventory`** — Per-audience rollup: contact count, unsubscribed count, last-broadcast timestamp, recent open-rate.

  _Use before planning a campaign — quickly see which audiences are healthy and recently engaged._

  ```bash
  resend-pp-cli audiences inventory --json
  ```
- **`contacts where`** — Find every audience, segment, and topic a contact (by email or name) belongs to in one query.

  _Use when triaging unsubscribe requests, GDPR deletions, or 'why is bob getting this email?'._

  ```bash
  resend-pp-cli contacts where <contact-email> --json --select audience_name,subscribed
  ```

### Aggregate analytics from local store
- **`broadcasts performance`** — Open / click / bounce rate across all broadcasts, sortable; not limited to a single broadcast or 30-day window.

  _Use to compare campaign performance across the lifetime of the account._

  ```bash
  resend-pp-cli broadcasts performance --json --select broadcasts,count,status
  ```
- **`domains health`** — Verification + DKIM/SPF/DMARC status across every domain in one table, flags missing or unverified records.

  _Use on call-out / deliverability incidents to confirm all sending domains are fully verified._

  ```bash
  resend-pp-cli domains health --json
  ```
- **`deliverability summary`** — Bounce rate, complaint rate, and suppression count over a rolling window (default 7d) computed from local event data.

  _Use weekly to monitor IP/domain reputation trends before they cause deliverability incidents._

  ```bash
  resend-pp-cli deliverability summary --window 7d --json
  ```

### Operational hygiene
- **`api-keys rotation`** — API keys sorted by age + last-used timestamp (joined from logs); flags stale keys older than N days.

  _Use during quarterly security reviews — find unused keys that should be rotated or revoked._

  ```bash
  resend-pp-cli api-keys rotation --older-than 90d --json
  ```

## Command Reference

**api-keys** — Create and manage API Keys through the Resend API.

- `resend-pp-cli api-keys create` — Create a new API key
- `resend-pp-cli api-keys delete` — Remove an existing API key
- `resend-pp-cli api-keys list` — Retrieve a list of API keys

**audiences** — Deprecated: Use Segments instead. Create and manage Audiences through the Resend API.

- `resend-pp-cli audiences create` — Deprecated: Use Segments instead. These endpoints still work, but will be removed in the future.
- `resend-pp-cli audiences delete` — Deprecated: Use Segments instead. These endpoints still work, but will be removed in the future.
- `resend-pp-cli audiences get` — Deprecated: Use Segments instead. These endpoints still work, but will be removed in the future.
- `resend-pp-cli audiences list` — Deprecated: Use Segments instead. These endpoints still work, but will be removed in the future.

**automations** — Create and manage Automations through the Resend API.

- `resend-pp-cli automations create` — Create an automation
- `resend-pp-cli automations delete` — Delete an automation
- `resend-pp-cli automations get` — Retrieve a single automation
- `resend-pp-cli automations list` — Retrieve a list of automations
- `resend-pp-cli automations update` — Update an automation

**broadcasts** — Create and manage Broadcasts through the Resend API.

- `resend-pp-cli broadcasts create` — Create a broadcast
- `resend-pp-cli broadcasts delete` — Remove an existing broadcast that is in the draft status
- `resend-pp-cli broadcasts get` — Retrieve a single broadcast
- `resend-pp-cli broadcasts list` — Retrieve a list of broadcasts
- `resend-pp-cli broadcasts update` — Update an existing broadcast

**contact-properties** — Create and manage Contact Properties through the Resend API.

- `resend-pp-cli contact-properties create` — Create a new contact property
- `resend-pp-cli contact-properties delete` — Remove an existing contact property
- `resend-pp-cli contact-properties get` — Retrieve a single contact property
- `resend-pp-cli contact-properties list` — Retrieve a list of contact properties
- `resend-pp-cli contact-properties update` — Update an existing contact property

**contacts** — Create and manage Contacts through the Resend API.

- `resend-pp-cli contacts create` — Create a new contact
- `resend-pp-cli contacts delete` — Remove an existing contact by ID or email
- `resend-pp-cli contacts get` — Retrieve a single contact by ID or email
- `resend-pp-cli contacts list` — Retrieve a list of contacts
- `resend-pp-cli contacts update` — Update a single contact by ID or email

**domains** — Create and manage domains through the Resend API.

- `resend-pp-cli domains create` — Create a new domain
- `resend-pp-cli domains delete` — Remove an existing domain
- `resend-pp-cli domains get` — Retrieve a single domain
- `resend-pp-cli domains list` — Retrieve a list of domains
- `resend-pp-cli domains update` — Update an existing domain

**emails** — Start sending emails through the Resend API.

- `resend-pp-cli emails create` — Send an email
- `resend-pp-cli emails create-batch` — Trigger up to 100 batch emails at once.
- `resend-pp-cli emails get` — Retrieve a single email
- `resend-pp-cli emails get-receiving` — Retrieve a single received email
- `resend-pp-cli emails get-receiving