revenuecat-cli

library0.1.20jsnpmunverified

rcat is an unofficial CLI for RevenueCat's REST API v2, enabling mobile developers to manage subscriptions, entitlements, offerings, customers, and analytics from the terminal. Version 0.1.20 targets Node.js >=16 and ships TypeScript declarations. Unlike the RevenueCat dashboard or SDKs, rcat provides a scriptable, terminal-based interface for common tasks like customer lookup, offering management, and revenue charting. It uses persistent config or environment variables for API v2 secret keys (sk_) and supports JSON output for integration with jq and CI/CD pipelines. Release cadence is irregular; breaking changes may occur before 1.0.

devops

npm install revenuecat-cli

package ↗

INSTALL

IMPORT

SIG · REVENUECAT-CLI

revenuecat-cli

devopsjavascriptv0.1.20

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

rcat (CLI)

✓ npm install -g revenuecat-cli && rcat --version

✗ npm install revenuecat-cli (without -g) && npx rcat

Global install is recommended for CLI usage. npx works but may be slower.

Configures authentication, lists offerings, retrieves a customer, and displays revenue overview.

rcat configure --api-key sk_your_secret_key --project-id proj1a2b3c4d rcat offerings list rcat customers get my_customer_id rcat charts overview

Debug

Known issues

breakingRequires RevenueCat API v2 secret keys (sk_). Public SDK keys (appl_, goog_) do not work.

fix

Generate a secret key from RevenueCat Dashboard > Project Settings > API Keys.

affects: >=0.1.0

deprecatedNode.js versions <16 are not supported; install may fail or behave unexpectedly.

fix

Upgrade to Node.js >=16.

affects: >=0.1.0

gotchaPersistent config is stored in system config directory (e.g., ~/Library/Preferences/revenuecat-cli-nodejs/ on macOS). Clearing it requires rcat configure clear or manual deletion.

fix

Use `rcat configure clear` to remove stored credentials.

affects: >=0.1.0

gotchaEnvironment variables (RCAT_API_KEY, RCAT_PROJECT_ID) override persistent config. This is not documented as a potential confusion point.

fix

Unset environment variables if you intend to use persistent config.

affects: >=0.1.0

breakingAPI v2 endpoint structure differs from v1. Commands and output may not match documentation from older versions.

fix

Ensure you are using RevenueCat API v2 and refer to its docs.

affects: >=0.1.0

Errors

Common errors & fixes

Error: Request failed with status code 401

Invalid or missing API key, or using a public SDK key instead of secret key.

fix

Run `rcat configure --api-key sk_...` with a valid secret key from RevenueCat dashboard.

Error: getaddrinfo ENOTFOUND api.revenuecat.com

Network connectivity issue or DNS resolution failure.

fix

Check internet connection and firewall settings. Ensure api.revenuecat.com is reachable.

Error: Cannot find module 'revenuecat-cli'

Package not installed globally, or npx not used.

fix

Install globally: `npm install -g revenuecat-cli`

Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules/revenuecat-cli'

Permission issue during global install on Unix systems.

fix

Use sudo: `sudo npm install -g revenuecat-cli` or configure npm prefix for your user.

Upgrade

Version history

0.1.20latest on npm

Audit

Dependencies

noderequiredruntime requirement, engine >=16

Agent activity

8 hits · last 30 days

node

Resources

packagerevenuecat-cli ↗