pp-revenuecat

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/payments/revenuecat/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/". -->

# RevenueCat — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `revenuecat-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 revenuecat --cli-only
   ```
2. Verify: `revenuecat-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/payments/revenuecat/cmd/revenuecat-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 you need programmatic or agent-driven visibility into RevenueCat mobile subscription state: revenue and MRR/ARR snapshots, churn and dunning analysis, entitlement reconciliation, refund tracing, and webhook config audits. It is the mobile-rail companion to a Lemon Squeezy CLI for the web rail.

## Anti-triggers

Do not use this CLI for:
- Do not use this CLI for the in-app purchase flow itself; that is the RevenueCat mobile SDK, not the server API.
- Do not use this CLI for browsing RevenueCat blog posts, docs, or State-of-Subscription reports; that is the marketing site, not the Developer API.
- Do not use this CLI for v1-only operations that v2 does not yet cover; fall back to the v1 API for those.

## Unique Capabilities

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

### Revenue intelligence
- **`revenue-snapshot`** — Point-in-time MRR, ARR, active subscriptions, trials, and revenue in your chosen currency, with deltas against your last snapshot.

  _Reach for this when an agent or operator asks 'where's revenue right now and how did it move since last check' in one call._

  ```bash
  revenuecat-pp-cli revenue-snapshot --currency USD --agent
  ```
- **`mrr-trend`** — MRR over time with new / expansion / contraction / churn movement decomposition and week-over-week deltas.

  _Reach for this to explain why MRR moved, not just that it moved._

  ```bash
  revenuecat-pp-cli mrr-trend --period week --limit 12 --agent
  ```
- **`trial-funnel`** — New trials to conversion-to-paying funnel with stage-to-stage drop-off.

  _Reach for this to see where trials leak before they convert._

  ```bash
  revenuecat-pp-cli trial-funnel --since 30d --agent
  ```

### Retention & risk
- **`churn-watch`** — Which subscriptions flipped to billing-issue, grace, expired, or cancelled in a window, with per-subscription dollar exposure.

  _Reach for this when you need who churned and how much MRR they took, not just the churn rate line._

  ```bash
  revenuecat-pp-cli churn-watch --since 7d --agent
  ```
- **`dunning-alert`** — Subscriptions still in grace or billing-issue state joined with their unpaid invoices, ranked by recoverable amount.

  _Reach for this to act on failed billing while the revenue is still recoverable._

  ```bash
  revenuecat-pp-cli dunning-alert --agent
  ```
- **`entitlement-rollup`** — Per-entitlement active-customer counts and product attachments, flagging customers whose entitlement state disagrees with their subscription state.

  _Reach for this to catch silent entitlement desync (a dropped webhook, a refund that didn't cascade) across the whole customer base._

  ```bash
  revenuecat-pp-cli entitlement-rollup --flag-disagreements --agent
  ```

### Operations
- **`refund-cascade`** — Traces a subscription or purchase through its transactions, refund history, and resulting entitlement loss; --apply issues the refund.

  _Reach for this to understand or execute a refund and see exactly which entitlements the customer loses._

  ```bash
  revenuecat-pp-cli refund-cascade sub1a2b3c4d --agent
  ```
- **`webhook-audit`** — Lists configured webhook integrations grouped by destination host, flagging duplicate or stale destinations.

  _Reach for this to confirm webhook delivery config before a dropped event silently desyncs entitlements._

  ```bash
  revenuecat-pp-cli webhook-audit --agent
  ```

## Command Reference

**apps** — Operations about apps.

- `revenuecat-pp-cli apps create` — This endpoint requires the following permission(s): project_configuration:apps:read_write .
- `revenuecat-pp-cli apps delete` — This endpoint requires the following permission(s): project_configuration:apps:read_write .
- `revenuecat-pp-cli apps get` — This endpoint requires the following permission(s): project_configuration:apps:read .
- `revenuecat-pp-cli apps list` — This endpoint requires the following permission(s): project_configuration:apps:read .
- `revenuecat-pp-cli apps update` — This endpoint requires the following permission(s): project_configuration:apps:read_write .

**audit-logs** — Operations about audit logs.

- `revenuecat-pp-cli audit-logs <project_id>` — This endpoint requires the following permission(s): project_configuration:audit_logs:read .

**charts** — Manage charts

- `revenuecat-pp-cli charts <project_id>` — Returns time-series data for a specific chart.

**collaborators** — Operations about collaborators.

- `revenuecat-pp-cli collaborators <project_id>` — This endpoint requires the following permission(s): project_configuration:collaborators:read .

**customers** — Operations about customers.

- `revenuecat-pp-cli customers create` — This endpoint requires the following permission(s): customer_information:customers:read_write .
- `revenuecat-pp-cli customers delete` — This endpoint requires the following permission(s): customer_information:customers:read_write .
- `revenuecat-pp-cli customers get` — This endpoint requires the following permission(s): customer_information:customers:read .
- `revenuecat-pp-cli customers list` — This endpoint requires the following permission(s): customer_information:customers:read .

**entitlements** — Operations about entitlements.

- `revenuecat-pp-cli entitlements create` — This endpoint requires the following permission(s): project_configuration:entitlements:read_write .
- `revenuecat-pp-cli entitlements delete` — This endpoint requires the following permission(s): project_configuration:entitlements:read_write .
- `revenuecat-pp-cli entitlements get` — This endpoint requires the following permission(s): project_configuration:entitlements:read .
- `revenuecat-pp-cli entitlements list` — This endpoint requires the following permission(s): project_configuration:entitlements:read .
- `revenuecat-pp-cli entitlements update` — This endpoint requires the following permission(s): project_configuration:entitlements:read_write .

**integrations** — Operations about integrations.

- `revenuecat-pp-cli integrations create-webhook` — This endpoint requires the following permission(s): project_configuration:integrations:read_write .
- `revenuecat-pp-cli integrations delete-webhook` — This endpoint requires the following permission(s): project_configuration:integrations:read_write .
- `revenuecat-pp-cli integrations get-webhook` — This endpoint requires the following permission(s): project_configuration:integrations:read .
- `revenuecat-pp-cli integrations list-webhook` — This endpoint requires the following permission(s): project_configur