@izantech/revenuecat-cli

Unofficial RevenueCat API v2 CLI for scripting and automation. Not affiliated with RevenueCat.

Install

npm install --save-dev @izantech/revenuecat-cli

Run directly with:

npx revcat --help

Install the bundled agentic skill (optional):

npx revcat install-skill codex --global

Authentication

Set a v2 secret API key and project id:

export REVENUECAT_SECRET_API_KEY=sk_...
export REVENUECAT_PROJECT_ID=proj_...

The CLI automatically loads .env.local and .env from the current directory and workspace root.

Quickstart

List available operations:

npx revcat api operations

Show one operation:

npx revcat api show create-product

Run an operation by id:

npx revcat api run list-products --query app_id=app_123 --query limit=20

Run with generated command aliases:

npx revcat products list --query app_id=app_123 --limit 20

For scripting, use JSON output:

npx revcat --format json subscriptions search --query customer_id=user_123

Mutation Safety

Mutating operations (POST / DELETE) require both --apply and --yes.

npx revcat products create --body-file ./payload.json
# blocked

npx revcat products create --body-file ./payload.json --apply --yes
# executes

Optional Config

Default config path: config/revenuecat-cli.json

{
  "defaultProfile": "prod",
  "profiles": {
    "prod": {
      "projectId": "proj_prod",
      "apiBaseUrl": "https://api.revenuecat.com/v2",
      "timeoutMs": 15000
    },
    "staging": {
      "projectId": "proj_staging"
    }
  }
}

Use a profile with:

npx revcat --profile staging api operations

Or environment variable:

export REV_CAT_PROFILE=staging

Agentic Skill Install

Install for Codex globally (~/.agents/skills):

npx revcat install-skill codex --global

Install for Codex in the current project (.agents/skills):

npx revcat install-skill codex --local

Install for Claude Code globally (~/.claude/commands):

npx revcat install-skill claude --global

Install for Claude Code in the current project (.claude/commands):

npx revcat install-skill claude --local

Install for Gemini CLI globally (~/.gemini/commands):

npx revcat install-skill gemini --global

Install for Gemini CLI in the current project (.gemini/commands):

npx revcat install-skill gemini --local

Install for Cursor in the current project (.cursor/rules, local-only):

npx revcat install-skill cursor --local

Install for Aider globally (~/.aider.conf.yml + ~/.aider/agentic-revcat.md):

npx revcat install-skill aider --global

Install for Aider in the current project (.aider.conf.yml + .aider/agentic-revcat.md):

npx revcat install-skill aider --local

Overwrite existing installation:

npx revcat install-skill claude --global --force

Docs

• Usage guide: docs/usage.md
• Command reference: docs/command-reference.md
• Scope matrix: docs/scope-matrix.md