Installation

GPC is free to use. Choose the installation method that fits your environment:

Method	Best For	Plugin Support	Auto-Update
Homebrew	macOS / Linux desktops	No	brew upgrade
npm	Node.js projects, CI/CD	Yes	npm update -g
Standalone binary	CI/CD, no Node.js required	No	Re-download
From source	Contributors, development	Yes	git pull

Homebrew

Recommended for macOS and Linux desktop users.

brew install yasserstudio/tap/gpc

Verify the installation:

gpc --version

Update to the latest version:

brew upgrade gpc

Uninstall:

brew uninstall gpc

npm

Recommended for Node.js projects and CI/CD pipelines. This is the only method that supports plugins.

npm install -g @gpc-cli/cli

Or with other package managers:

pnpm add -g @gpc-cli/cli

yarn global add @gpc-cli/cli

Verify the installation:

gpc --version

Update to the latest version:

npm update -g @gpc-cli/cli

Uninstall:

npm uninstall -g @gpc-cli/cli

Agent Skills

If you use Claude Code or another AI coding assistant, install the GPC agent skills to get guided help with Google Play workflows:

gpc install-skills

The interactive wizard lets you select from 16 skills covering setup, releases, metadata, vitals, CI/CD, monetization, and more. See the Agent Skills page for the full list.

Standalone Binary

Pre-compiled binaries with no runtime dependencies. Ideal for CI/CD environments without Node.js.

Automatic install (recommended)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/yasserstudio/gpc/main/scripts/install.sh | sh

This script detects your platform, downloads the correct binary, and places it in /usr/local/bin.

Windows (PowerShell):

iwr https://raw.githubusercontent.com/yasserstudio/gpc/main/scripts/install.ps1 | iex

This downloads the binary to %LOCALAPPDATA%\Programs\gpc and adds it to your user PATH automatically.

Windows (Git Bash / MSYS2):

curl -fsSL https://raw.githubusercontent.com/yasserstudio/gpc/main/scripts/install.sh | sh

The shell script auto-detects Windows and installs gpc.exe to %LOCALAPPDATA%\Programs\gpc.

Manual download

Download the binary for your platform from the GitHub releases page.

Platform support

Platform	Architecture	Binary
macOS	arm64 (Apple Silicon)	gpc-darwin-arm64
macOS	x64 (Intel)	gpc-darwin-x64
Linux	x64	gpc-linux-x64
Linux	arm64	gpc-linux-arm64
Windows	x64	gpc-windows-x64.exe

Manual install steps (Linux/macOS)

# Download the binary (replace PLATFORM with darwin-arm64, darwin-x64, or linux-x64)
curl -fsSL -o gpc "https://github.com/yasserstudio/gpc/releases/latest/download/gpc-PLATFORM"

# Make it executable
chmod +x gpc

# Move to a directory in your PATH
sudo mv gpc /usr/local/bin/gpc

# Verify
gpc --version

Manual install steps (Windows)

# Download the binary
$Dir = "$env:LOCALAPPDATA\Programs\gpc"
New-Item -ItemType Directory -Path $Dir -Force
Invoke-WebRequest -Uri "https://github.com/yasserstudio/gpc/releases/latest/download/gpc-windows-x64.exe" -OutFile "$Dir\gpc.exe"

# Add to user PATH (once)
$Path = [Environment]::GetEnvironmentVariable("Path", "User")
if ($Path -notlike "*$Dir*") {
  [Environment]::SetEnvironmentVariable("Path", "$Path;$Dir", "User")
}

# Verify (open a new terminal first)
gpc --version

Uninstall:

sudo rm /usr/local/bin/gpc

From Source

For contributors or if you need the latest unreleased changes.

Prerequisites

• Node.js 20 or later
• pnpm 9.15 or later

Steps

git clone https://github.com/yasserstudio/gpc.git
cd gpc
pnpm install
pnpm build

Link the CLI globally:

cd packages/cli
pnpm link --global

Verify the installation:

gpc --version

Run tests:

pnpm test

Update to the latest version:

git pull origin main
pnpm install
pnpm build

Uninstall:

pnpm unlink --global gpc

CI/CD Installation

GitHub Actions

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

- name: Authenticate
  run: gpc auth login --service-account "${{ secrets.GPC_SERVICE_ACCOUNT_JSON }}"

Or with the standalone binary (no Node.js required):

- name: Install GPC
  run: curl -fsSL https://raw.githubusercontent.com/yasserstudio/gpc/main/scripts/install.sh | sh

GitLab CI

before_script:
  - npm install -g @gpc-cli/cli
  - gpc auth login --service-account "$GPC_SERVICE_ACCOUNT_JSON"

Docker

FROM node:20-slim
RUN npm install -g @gpc-cli/cli

Or with the standalone binary:

FROM alpine:latest
RUN curl -fsSL https://raw.githubusercontent.com/yasserstudio/gpc/main/scripts/install.sh | sh

Verify Installation

After installing with any method, run the doctor command to verify your setup:

gpc doctor

This checks:

• GPC binary is accessible and reports its version
• Node.js version is 20 or later (npm installs only)
• Network connectivity to googleapis.com
• Authentication credentials are configured and valid
• Config file is found and valid (if present)
• API quota proximity (warns if usage exceeds 80%)
• Plugin health (verifies each configured plugin loads)

Shell Completions

Homebrew installs these automatically

brew install yasserstudio/tap/gpc writes completion files for bash, zsh, and fish on install. No setup step required. Restart your shell (or run compinit / exec zsh) to pick them up.

For npm or standalone-binary installs, generate shell completions manually:

# Bash — add to ~/.bashrc
eval "$(gpc completion bash)"

# Zsh — add to ~/.zshrc
eval "$(gpc completion zsh)"

# Fish — add to ~/.config/fish/config.fish
gpc completion fish | source

Or save to a file:

gpc completion bash > /usr/local/etc/bash_completion.d/gpc
gpc completion zsh > "${fpath[1]}/_gpc"
gpc completion fish > ~/.config/fish/completions/gpc.fish

Completions fill in live values for --profile, --app, and --track by consulting your config and the gpc status cache at TAB time. See Shell completion reference for details.

Next Steps

• Quick Start — Authenticate and run your first commands
• Authentication — Set up service accounts, OAuth, or ADC
• Configuration — Config files, environment variables, and profiles
• Migration from Fastlane — Most commands map one-to-one