@gpc-cli/cli

Ship Android apps from your terminal.

The complete CLI for Google Play — 204 API endpoints, one tool.
Releases, rollouts, metadata, vitals, reviews, subscriptions, reports, and more.

Install

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

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

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

# Standalone binary — Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/yasserstudio/gpc/main/scripts/install.ps1 | iex

Free. Open-source. No account required beyond your existing Google Play service account.

Quick Start

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

# Verify your setup (20 automated checks)
gpc doctor

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

# Upload and release (AAB or APK)
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

204 API endpoints across these command groups:

Group	What you can do
Releases	Upload AAB/APK, promote, rollout increase/halt/resume, draft releases, `publish`
Preflight	9 offline AAB policy scanners — catches rejections before upload
Listings	Pull and push store listings, upload screenshots — Fastlane metadata compatible
Reviews	Filter by stars, reply (350-char validated), auto-paginate, export to CSV
Vitals	Crash rates, ANR, startup, rendering, battery, memory — with CI threshold gates
Status	Releases + vitals + reviews in one command, `--watch`, `--since-last` diff
Bundle	Per-module size breakdown, build-to-build diff, size CI gates
Subscriptions	Base plans, offers, pricing, batch operations, RTDN notification decoding
IAP / OTP	One-time products, purchase options, batch get/update/delete
Purchases	Verify, acknowledge, cancel, refund, voided (with `--type` subscription filter)
Reports	Financial and stats report downloads
Testers	Add, remove, import from CSV
Users	Invite, update, remove, manage per-app grants
Doctor	20 automated setup checks — config, auth, connectivity, app access, key age
Anomalies	Auto-detect vitals quality spikes from Reporting API
More	Init, diff, changelog, quota, train, cache, feedback, enterprise, games

Exit Codes

Code	Meaning
`0`	Success
`1`	General error
`2`	Usage error (bad arguments)
`3`	Authentication error
`4`	API error (rate limit, permission)
`5`	Network error
`6`	Threshold breach (vitals CI alerting)

CI/CD Ready

JSON output when piped. Formatted tables in your terminal. Semantic exit codes (0-6) your CI can react to. Every write operation supports --dry-run.

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

Already on Fastlane? See the migration guide — most commands map one-to-one.

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