Quickstart

With gplay installed and authenticated, here’s the 5-minute tour.

See your apps

gplay apps list

Set a default package so you can drop --package from every command:

gplay init   # writes ./.gplay/config.yaml with default_package

Release in one command

gplay release wraps the whole edit-session dance — create edit, upload, assign track, commit:

gplay release --package com.example.app --track internal --bundle app.aab

Production with release notes and a 10% staged rollout (--rollout is a fraction, 0.0–1.0):

gplay release --package com.example.app --track production \
  --bundle app.aab --release-notes @notes.json --rollout 0.1

Manage the rollout

gplay rollout status   --package com.example.app --track production
gplay rollout update   --package com.example.app --track production --rollout 0.5
gplay rollout halt     --package com.example.app --track production
gplay rollout complete --package com.example.app --track production

Promote between tracks

gplay promote --package com.example.app --from internal --to beta

Preview any write with –dry-run

Every mutating command supports --dry-run — it logs the HTTP requests it would make and executes nothing:

gplay --dry-run release --package com.example.app --track internal --bundle app.aab

Everything is JSON

Output is minified JSON by default — built for scripts, pipes, and AI agents:

gplay reviews list --package com.example.app | jq '.reviews[0]'
gplay tracks list --package com.example.app --output table   # for humans

Where to go next

• Command Reference — every command and flag
• Use with AI agents — skills for Claude Code, Cursor, and friends
• GitHub — source, issues, releases