mcpField
G
gpc-vitals

gpc-vitals

github.com/androidpoetTesting & quality440 installsUpdated 17w ago
Repository

About gpc-vitals

A skill for querying Android app health metrics from the command line, intended for teams monitoring apps on Google Play. It covers crashes, ANRs, startup and rendering metrics, and supports comparisons across time periods.

Key features

  1. 01View app health overviews
  2. 02Query crash and ANR rates
  3. 03Check startup and rendering performance
  4. 04Monitor wakeups, wakelocks, and memory
  5. 05View error counts and grouped issues

Use cases

  1. 01Tracking recent app health trends
  2. 02Assessing metric changes around a release
  3. 03Investigating crashes or ANRs
  4. 04Checking startup, rendering, and memory conditions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/androidpoet/playconsole-cli-skills --skill gpc-vitals

After installing, type/gpc-vitalsin Claude Code to confirm it loaded.

Details

From the project README

Android Vitals

Use this skill when monitoring app health metrics, crash rates, ANR rates, or performance indicators.

Overview

gpc vitals overview --package com.example.app
gpc vitals overview --days 28 --package com.example.app

Individual metrics

Crash rate
gpc vitals crashes --package com.example.app
gpc vitals crashes --days 7 --package com.example.app
ANR rate
gpc vitals anr --package com.example.app
gpc vitals anr --days 7 --package com.example.app
Slow startup
gpc vitals slow-start --package com.example.app
Slow rendering (jank)
gpc vitals slow-rendering --package com.example.app
Excessive wakeups
gpc vitals wakeups --package com.example.app
Stuck wakelocks
gpc vitals wakelocks --package com.example.app
Low memory killer
gpc vitals memory --package com.example.app

Error tracking

View error counts
gpc vitals errors --package com.example.app
gpc vitals errors --days 7 --package com.example.app
List grouped error issues
gpc vitals errors issues --package com.example.app

Health check workflow

Run a full health assessment:

gpc vitals overview --days 7 --package com.example.app -o table
gpc vitals crashes --days 7 --package com.example.app -o table
gpc vitals anr --days 7 --package com.example.app -o table

Agent behavior

  • Default to --days 7 for recent trends, --days 28 for overall health.
  • Use -o table when presenting to user; -o json for data processing.
  • Flag metrics that exceed Google Play's bad behavior thresholds:
    • Crash rate > 1.09%
    • ANR rate > 0.47%
  • Compare before/after a release to detect regressions.

Notes

  • Vitals data uses Play Developer Reporting API v1beta1.
  • Data may have 24-48 hour delay.
  • Upload ProGuard mappings (gpc deobfuscation upload) for readable crash stacks.
  • See gpc-build-lifecycle skill for deobfuscation upload.

Comments

Markdown supported