GPC — Google Play Console CLI

<a href="https://www.npmjs.com/package/@gpc-cli/cli"><img src="https://img.shields.io/npm/v/@gpc-cli/cli?style=for-the-badge&color=00D26A" alt="npm version"></a> <a href="https://github.com/yasserstudio/gpc/stargazers"><img src="https://img.shields.io/github/stars/yasserstudio/gpc?style=for-the-badge" alt="GitHub Stars"></a> <img src="https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript" alt="TypeScript"> <img src="https://img.shields.io/badge/Node.js-20+-339933?style=for-the-badge&logo=node.js" alt="Node.js"> <img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="License"> <a href="https://www.npmjs.com/package/@gpc-cli/cli"><img src="https://img.shields.io/npm/dm/@gpc-cli/cli?style=for-the-badge&color=00BFA5" alt="npm downloads"></a> <a href="https://yasserstudio.github.io/gpc/"><img src="https://img.shields.io/badge/Docs-yasserstudio.github.io%2Fgpc-00D26A?style=for-the-badge" alt="Documentation"></a> <img src="https://img.shields.io/badge/Tests-1874_passing-00D26A?style=for-the-badge" alt="Tests"> <img src="https://img.shields.io/badge/Coverage-90%25+-00BFA5?style=for-the-badge" alt="Coverage"> Ship Android apps from your terminal. Built for Android developers, release engineers, and DevOps teams who are done clicking through the Play Console. The complete CLI for Google Play — 215 API endpoints, one tool. Releases, rollouts, metadata, vitals, reviews, subscriptions, reports, and more. Plus an offline compliance scanner that catches policy violations before you upload. <a href="#install">Install in 30 seconds</a> · <a href="https://yasserstudio.github.io/gpc/guide/quick-start">Quick Start Guide</a> · <a href="https://github.com/yasserstudio/gpc">GitHub</a>

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 to use. 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
gpc doctor

# 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 with staged rollout
gpc releases promote --from internal --to production --rollout 10

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

Why GPC?

Every Android release is the same ritual: open the Play Console, upload your AAB, copy-paste release notes, pick a track, set the rollout percentage, click through confirmation screens. Fifteen minutes of clicking, every single time.

GPC covers the entire Google Play Developer API in one CLI. 215 endpoints. No Ruby. No browser. No ceremony.

| | GPC | Fastlane supply | gradle-play-publisher | Console UI | | ------------------- | ---------------------------- | --------------- | --------------------- | ------------ | | API coverage | 215 endpoints | ~20 | ~15 | All (manual) | | Runtime | Node.js or standalone binary | Ruby + Bundler | JVM | Browser | | Cold start | <500ms | 2-3s | 3-5s | 5-10s | | Reviews & Vitals | Yes | No | No | Yes (manual) | | Subscriptions & IAP | Yes | No | No | Yes (manual) | | CI/CD native | JSON + exit codes + env vars | Partial | Gradle tasks | No | | Preflight scanner | 9 offline policy checks | No | No | No | | Interactive mode | Yes (guided prompts) | No | No | N/A | | Test suite | 1,882 tests, 90%+ coverage | | | |

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

Ship

From first upload to full production rollout, without touching a browser.

gpc publish app.aab --track beta --notes "Bug fixes"      # End-to-end flow
gpc releases upload app.aab --track internal               # Upload to any track
gpc releases promote --from beta --to production --rollout 5
gpc releases rollout increase --track production --to 50
gpc releases rollout halt --track production               # Emergency brake
gpc validate app.aab --track beta                          # Dry-run before committing

Manage store listings, screenshots, and localization. Works with Fastlane metadata format.

gpc listings pull --dir metadata/          # Download all listings
gpc listings push --dir metadata/          # Upload local changes
gpc listings images upload --lang en-US --type phoneScreenshots ./screens/*.png

Monitor

Know if something broke before your users do.

gpc status                                 # Releases + vitals + reviews in one view
gpc status --watch 60                      # Live polling every 60 seconds
gpc status --all-apps                      # Check all your apps at once
gpc vitals crashes --threshold 2.0         # Exit code 6 if breached — CI gate
gpc reviews list --stars 1-2 --since 7d    # Filter reviews by stars and date
gpc reviews reply <id> --text "Thanks!"    # Reply without opening a browser

Handle monetization from the terminal.

gpc subscriptions list
gpc iap sync --dir products/
gpc pricing convert --from USD --amount 9.99

Protect

Catch problems before Google does. No other tool does this.

gpc preflight app.aab                        # Run all 9 scanners
gpc preflight app.aab --fail-on error --json # CI quality gate (exit code 6)
gpc preflight permissions app.aab            # 18 restricted permissions audit
gpc preflight --source app/src               # Secrets, billing SDKs, tracking

9 scanners run in parallel: manifest (target SDK, debuggable, exported, foreground service types), permissions (18 restricted permissions), native-libs (64-bit compliance), metadata (listing limits, screenshots), secrets (AWS, Google, Stripe keys), billing (non-Play SDKs), privacy (tracking SDKs), policy (Families/COPPA), size (download warnings).

Diagnose your setup with 20 automated checks.

gpc doctor                  # Run all checks
gpc doctor --fix            # Auto-fix what it can
gpc doctor --json           # Structured output for CI

Analyze bundle size and catch regressions.

gpc bundle analyze app.aab                   # Per-module breakdown
gpc bundle compare old.aab new.aab           # Size diff between builds
gpc bundle analyze app.aab --threshold 150   # CI gate if > 150 MB

CI/CD

Drop GPC into any pipeline. JSON output, semantic exit codes (0-6), env var config.

GitHub Actions

- name: Install GPC
  run: npm install -g @gpc-cli/cli

- name: Preflight Compliance Check
  run: gpc preflight app.aab --fail-on error

- name: Upload to Internal Track
  env:
    GPC_SERVICE_ACCOUNT: ${{ secrets.GPC_SERVICE_ACCOUNT }}
    GPC_APP: com.example.myapp
  run: gpc releases upload app.aab --track internal

- name: Gate on Vitals
  run: |
    gpc vitals crashes --output json | jq -e '.data.crashRate < 2.0'

GitLab CI

deploy:
  image: node:20
  script:
    - npm install -g @gpc-cli/cli
    - gpc releases upload app.aab --track production --rollout 10
  variables:
    GPC_SERVICE_ACCOUNT: $GPC_SERVICE_ACCOUNT
    GPC_APP: com.example.myapp

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) |

See the full CI/CD recipes for GitHub Actions, GitLab CI, Bitbucket Pipelines, and CircleCI.

Developer Experience

Smart output — formatted tables in your terminal, structured JSON when piped or in CI. Override with --output json|yaml|markdown.
Dry run everything — every write command supports --dry-run. Run your full pipeline against real data without publishing a thing.
Interactive prompts — miss a required flag and GPC asks. In CI, it fails fast instead. Disable with --no-interactive.
Four auth methods — service account, OAuth,

Gpc

Install / Use

README