Pp Lemonsqueezy

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

Lemon Squeezy — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the lemonsqueezy-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:

   npx -y @mvanhorn/printing-press-library install lemonsqueezy --cli-only

2. Verify: lemonsqueezy-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.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/payments/lemonsqueezy/cmd/lemonsqueezy-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

Reach for this CLI when running ongoing Lemon Squeezy operations — Monday-morning revenue/churn sweeps, post-refund license-key disables, live capacity tracking during a capped sale, or webhook coverage audits across multiple stores. The cross-entity SQL and transcendence commands are the differentiator. For one-shot dashboard tasks (creating one product, editing a single discount) the LS web UI is still faster.

Anti-triggers

Do not use this CLI for:

• Building a custom checkout form in a web app — use the official lemonsqueezy.js JavaScript SDK (the CLI is for ops, not embedded billing).
• Receiving webhook payloads in production — this CLI can replay and audit webhooks, but the actual HTTP server lives in your application.
• Tax/VAT reporting — Lemon Squeezy is merchant-of-record and ships its own tax docs in the dashboard; this CLI doesn't replicate them.
• Customer-facing license validation in your desktop app — call the LS license API directly from the app, not via this CLI.

Catalog setup rule (public API limitation)

Do not try to create Lemon Squeezy products, variants, or digital files through the public API. Official docs and OPTIONS checks show those catalog resources are list/get only. import products, import variants, and import files intentionally refuse with resource_read_only / operation_not_supported_by_public_api instead of emitting fake POST dry-runs.

Use these commands instead:

# Ask what writes are supported before mutating anything.
lemonsqueezy-pp-cli capabilities --json
lemonsqueezy-pp-cli which "create product" --json
lemonsqueezy-pp-cli which "upload file" --json

# Prepare a dashboard handoff packet for catalog setup.
lemonsqueezy-pp-cli dashboard handoff product \
  --name "Juno Home Chief of Staff Starter Kit" \
  --slug juno-home-chief-of-staff-starter-kit \
  --sku juno-home-chief-of-staff-starter-kit \
  --price-usd 149 \
  --type "digital download" \
  --redirect-url https://www.littlemight.com/ai-house-manager/thank-you/ \
  --affiliate-percent 25 \
  --affiliate-approval "manual approval" \
  --affiliate-cookie-days 30 \
  --json

# After the dashboard-created variant exists, create checkout URLs via API.
lemonsqueezy-pp-cli checkouts create --store-id <STORE_ID> --variant-id <VARIANT_ID> --dry-run --json

Checkout creation is supported by POST /v1/checkouts only after you already have a valid store ID and variant ID. Live checkouts create validates both before POSTing and returns the checkout URL/ID.

Unique Capabilities

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

Revenue + churn signal

• revenue-snapshot — Point-in-time revenue rollup combining LS's denormalized 30-day/lifetime store counters with refund-adjusted net from local orders.

  Reach for this when you want one number for 'how is the store doing right now' without walking every order through the API.

  lemonsqueezy-pp-cli revenue-snapshot --agent

• mrr-trend — Weekly MRR over a sliding window, classified as new / renewal / refunded with a week-over-week net delta.

  Pick this over a raw list-subscriptions call when you need to show how MRR moved week-over-week, not just where it stands today.

  lemonsqueezy-pp-cli mrr-trend --weeks 12 --json

• churn-watch — Lists subscriptions that flipped to past_due/unpaid/cancelled/expired in a window, with customer email and dollar exposure per row.

  Reach for this on Monday-morning sweeps to see what changed since Friday — beats clicking through the dashboard's status filters.

  lemonsqueezy-pp-cli churn-watch --since 7d --json

• dunning-alert — Lists subscription-invoices with status=failed whose parent subscription is still active or past_due — the recoverable window.

  Use this to find subs whose latest renewal failed but who haven't churned yet — the window where a Slack ping or grace email recovers revenue.

  lemonsqueezy-pp-cli dunning-alert --json

License + refund ops

• license-rollup — Per-variant and per-key activation statistics joined across license-keys, license-key-instances, and variants.

  Reach for this when you need to surface piracy-shaped seat distributions or just answer 'how many keys are active per variant'.

  lemonsqueezy-pp-cli license-rollup --json --select keys

• refund-cascade — Given a refunded order ID, walks order → order-items → license-keys → instances, then optionally disables the keys via --apply.

  Use this after a refund hits, to make sure the buyer's license keys actually get disabled instead of staying active.

  lemonsqueezy-pp-cli refund-cascade order_3aBc --dry-run --json

Campaign + integration ops

• campaign-watch — Per discount code: redemptions used vs cap, redemption velocity over last 24h, projected sellout time at current pace (needs >=6h of redemption activity to stabilise).

  Run this during a capped sale (Founding-Member tier, Early Access) to know when a tier will sell out so you can expire the code before overselling.

  lemonsqueezy-pp-cli campaign-watch FOUNDING-LIFETIME FOUNDING-2YR FOUNDING-1YR --json

• webhook-audit — Cross-store webhook coverage matrix grouped by URL host, flagging stale destinations (localhost, ngrok, *.test, *.local).

  Reach for this to catch orphaned webhooks pointing at last week's ngrok URL before they cause a missed event in production.

  lemonsqueezy-pp-cli webhook-audit --json

Command Reference

agent-native catalog workflows — Public API capability discovery and dashboard handoffs

• lemonsqueezy-pp-cli capabilities — Show public API list/get/create/update/delete support by resource
• lemonsqueezy-pp-cli dashboard — Dashboard-only Lemon Squeezy workflows and handoff packets
• lemonsqueezy-pp-cli dashboard handoff — Generate dashboard handoff artifacts for unsupported public API writes
• lemonsqueezy-pp-cli dashboard handoff product — Generate exact dashboard fields for a product/variant/file setup handoff
• lemonsqueezy-pp-cli import <resource> — Import JSONL records only for API-writable resources; refuses products/variants/files as read-only
• lemonsqueezy-pp-cli which [query] — Resolve natural-language capability requests, including negative catalog guidance

affiliates — Manage affiliates

• lemonsqueezy-pp-cli affiliates get — Lemon Squeezy Retrieve an affiliate
• lemonsqueezy-pp-cli affiliates list — Lemon Squeezy List all affiliates

checkouts — Manage checkouts

• lemonsqueezy-pp-cli checkouts create — Create a checkout URL for an existing store/variant; supports safe JSON:API dry-run and live preflight validation
• lemonsqueezy-pp-cli checkouts get — Lemon Squeezy Retrieve a checkout
• lemonsqueezy-pp-cli checkouts list — Lemon Squeezy List all checkouts

customers — Manage customers

• lemonsqueezy-pp-cli customers get — Lemon Squeezy Retrieve a customer
• lemonsqueezy-pp-cli customers list — Lemon Squeezy List all customers

discount-redemptions — Manage discount redemptions

• lemonsqueezy-pp-cli discount-redemptions get — Lemon Squeezy Retrieve a discount redemption
• lemonsqueezy-pp-cli discount-redemptions list — Lemon Squeezy List all discount redemptions

discounts — Manage discounts

• lemonsqueezy-pp-cli discounts create — Lemon Squeezy Create a discount
• lemonsqueezy-pp-cli discounts delete — Lemon Squeezy Delete a discount
• lemonsqueezy-pp-cli discounts get — Lemon Squeezy Retrieve a discount
• lemonsqueezy-pp-cli discounts list — Lemon Squeezy List all discounts

files — Manage files

• lemonsqueezy-pp-cli files get — Lemon Squeezy Retrieve a file
• lemonsqueezy-pp-cli files list — Lemon Squeezy List all files

health — Manage health

• lemonsqueezy-pp-cli health — Lemon Squeezy Health

license-key-instances — Manage license key instances

• lemonsqueezy-pp-cli license-key-instances get — Lemon Squeezy Retrieve a license key instance
• lemonsqueezy-pp-cli license-key-instances list — Lemon Squeezy List all license key instances

license-keys — Manage license keys

• lemonsqueezy-pp-cli license-keys get — Lemon Squeezy Retrieve a license key
• lemonsqueezy-pp-cli license-keys list — Lemon Squeezy List all license keys

order-items — Manage order items

• lemonsqueezy-pp-cli order-items get — Lemon Squeezy Retrieve an order item
• lemonsqueezy-pp-cli order-items list — Lemon Squeezy List all order items

orders — Manage orders

• lemonsqueezy-pp-cli orders get — Lemon Squeezy Retrieve an order
• lemonsqueezy-pp-cli orders list — Lemon Squeezy List all orders

prices — Manage prices

• lemonsqueezy-pp-cli prices get — Lemon Squeezy Retrieve a price
• lemonsqueezy-pp-cli prices list — Lemon Squeezy List all prices

products — Manage products

• lemonsqueezy-pp-cli products get — Lemon Squeezy Retrieve a product
• lemonsqueezy-pp-cli products list — Lemon Squeezy List all products

stores — Manage stores

• lemonsqueezy-pp-cli stores get — Lemon Squeezy Retrieve a store
• lemonsqueezy-pp-cli stores list — Lemon Squeezy List all stores

subscription-invoices — Manage subscription invoices

• lemonsqueezy-pp-cli subscription-invoices get — Lemon Squeezy Retrieve a subscription invoice
• lemonsqueezy-pp-cli subscription-invoices list — Lemon Squeezy List all subscription invoices

subscription-items — Manage subscription items

• lemonsqueezy-pp-cli subscription-items get — Lemon Squeezy Retrieve a subscription item
• lemonsqueezy-pp-cli subscription-items list — Lemon Squeezy List all subscription items
• lemonsqueezy-pp-cli subscription-items update — Lemon Squeezy Update a subscription item

subscriptions — Manage subscriptions

• lemonsqueezy-pp-cli subscriptions delete — Lemon Squeezy Cancel a Subscription
• lemonsqueezy-pp-cli subscriptions get — Lemon Squeezy Retrieve a subscription
• lemonsqueezy-pp-cli subscriptions list — Lemon Squeezy List all subscriptions
• lemonsqueezy-pp-cli subscriptions update — Lemon Squeezy Update a subscription

usage-records — Manage usage records

• lemonsqueezy-pp-cli usage-records create — Lemon Squeezy Create a usage record
• lemonsqueezy-pp-cli usage-records get — Lemon Squeezy Retrieve a usage-record
• lemonsqueezy-pp-cli usage-records list — Lemon Squeezy List all usage records

users — Manage users

• lemonsqueezy-pp-cli users — Lemon Squeezy Retrieve the authenticated user

variants — Manage variants

• lemonsqueezy-pp-cli variants get — Lemon Squeezy Retrieve a variant
• lemonsqueezy-pp-cli variants list — Lemon Squeezy List all variants

webhooks — Manage webhooks

• lemonsqueezy-pp-cli webhooks create — Lemon Squeezy Create a webhook
• lemonsqueezy-pp-cli webhooks delete — Lemon Squeezy Delete a webhook
• lemonsqueezy-pp-cli webhooks get — Lemon Squeezy Retrieve a webhook
• lemonsqueezy-pp-cli webhooks list — Lemon Squeezy List all webhooks
• lemonsqueezy-pp-cli webhooks update — Lemon Squeezy Update a webhook