@gpc-cli/cli

Install

# npm (includes plugin support)
npm install -g @gpc-cli/cli

# Homebrew (macOS/Linux)
brew install yasserstudio/tap/gpc

# Standalone binary (no Node.js required)
curl -fsSL https://raw.githubusercontent.com/yasserstudio/gpc/main/scripts/install.sh | sh

Quick Start

# Authenticate
gpc auth login --service-account path/to/key.json

# App health at a glance — releases, vitals, and reviews in one command
gpc status

# Upload and release
gpc releases upload app.aab --track internal

# Promote to production
gpc releases promote --from internal --to production --rollout 10

# Monitor reviews
gpc reviews list --stars 1-3 --since 7d

App Health at a Glance

$ gpc status

App: com.example.myapp · My App  (fetched 10:42:01 AM)

RELEASES
  production   v1.4.2   completed    —
  beta         v1.5.0   inProgress  10%
  internal     v1.5.1   draft        —

VITALS  (last 7 days)
  crashes     0.80%  ✓    anr         0.20%  ✓
  slow starts 2.10%  ✓    slow render 4.30%  ⚠

REVIEWS  (last 30 days)
  ★ 4.6   142 new   89% positive   ↑ from 4.4

6 parallel API calls, results in under 3 seconds. Results cached — --cached skips the network entirely.

What You Get

187 API endpoints across these command groups:

| Group | Examples | | ----------------- | -------------------------------------------------------------- | | Releases | upload, promote, rollout increase/halt/resume, publish | | Listings | pull, push, images upload/delete, Fastlane format | | Reviews | list, reply, export --format csv | | Vitals | crashes, anr, startup, rendering, battery, memory | | Bundle | analyze (size breakdown), compare (size diff) | | Subscriptions | list, create, update, base-plans, offers | | IAP | list, create, sync --dir products/, batch-get/update | | Purchases | get, acknowledge, cancel, refund, voided list | | Reports | download financial, download stats | | Testers | add, remove, import --file testers.csv | | Users | invite, update, remove, per-app grants |

CI/CD Ready

JSON output when piped. Formatted tables in your terminal. Semantic exit codes (0-6) your CI can react to.

- name: Upload
  env:
    GPC_SERVICE_ACCOUNT: ${{ secrets.GPC_SERVICE_ACCOUNT }}
    GPC_APP: com.example.myapp
  run: |
    npm install -g @gpc-cli/cli
    gpc releases upload app.aab --track internal

Every write operation supports --dry-run.

Part of the GPC Monorepo

| Package | Description | | ------------------------------------------------------------------------ | -------------------------------------------- | | @gpc-cli/cli | CLI entry point (this package) | | @gpc-cli/core | Business logic and orchestration | | @gpc-cli/api | Typed Google Play API v3 client | | @gpc-cli/auth | Authentication (service account, OAuth, ADC) | | @gpc-cli/config | Configuration and profiles | | @gpc-cli/plugin-sdk | Plugin interface and lifecycle hooks | | @gpc-cli/plugin-ci | CI/CD helpers |

Documentation

Full docs at yasserstudio.github.io/gpc

License

MIT