stripe-pulse

# stripe-pulse — Stripe SaaS Metrics CLI Get MRR, ARR, churn, LTV, NRR, quick ratio, MRR movements, reactivations — directly from Stripe subscriptions. **Install:** `npm install -g stripe-pulse` **Quick check:** `stripe-pulse mrr --json` **Everything at once:** `stripe-pulse dashboard --json` ## When to Use - User asks about MRR, revenue, churn, customers, or any SaaS metric - User asks about returning customers, reactivations, or win-backs - Updating pulse.md or state files that track MRR - Running freshness guards that check Stripe data - User wants to export metrics (CSV, markdown, JSON) - User says "check stripe", "what's our MRR", "how's churn looking", "any reactivations" - Comparing metrics across profiles/accounts ## Quick Start ```bash # First time: authenticate stripe-pulse login # Check MRR stripe-pulse mrr --json # → { "mrr": 392, "arr": 4704, "currency": "usd", "activeSubscriptions": 18, "breakdown": [...] } # Full dashboard (most efficient — one call, all metrics) stripe-pulse dashboard --json # → { "mrr": ..., "churn": ..., "reactivatedCustomers": ..., "reactivations": [...], ... } ``` ## Authentication Three-tier auth chain (highest priority wins): 1. `--api-key <key>` flag on any command 2. `STRIPE_API_KEY` environment variable 3. Credentials file at `~/.config/stripe-pulse/credentials.json` Multi-account: `stripe-pulse mrr --profile activecalculator --json` Supports full keys (`sk_live_*`, `sk_test_*`) and restricted keys (`rk_live_*`, `rk_test_...