Skip to content

Reference

qa-pr

Device-test a GitHub pull request. Pins the PR head in an isolated copy, installs through the rn-dev-agent session, exercises the change, and reports pass/fail with repro steps and screenshots.

Claude: /rn-dev-agent:qa-pr <PR URL or number> [--platform ios|android|device|all]
Codex: $rn-dev-agent:qa-pr <PR URL or number> [ios|android|device|all]

Default platform is all — every target that can be proven present. A requested target that is not on the machine is SKIP with the setup gap, not FAIL.

/rn-dev-agent:qa-pr 812
/rn-dev-agent:qa-pr https://github.com/acme/app/pull/42 --platform ios
/rn-dev-agent:qa-pr 42 --platform device
StepWhat happens
1Fetch the PR with gh pr view
2Classify app-facing vs docs-only vs plugin-under-test-app
3Pin the head SHA in a disposable git worktree
4Establish the run-workflow operating sequence
5Bind one exact device, apply integration, run the managed package script
6Exercise the change (artifact-first; login via cdp_login_prologue)
7Reverse cleanup and post a GitHub comment with hosted screenshots and video
  • Verdict for the PR URL + head SHA (PASS / FAIL / PARTIAL / SKIP)
  • Per-target evidence (hosted screenshot + video, route, error count)
  • Repro steps a human can follow
  • A gh pr comment with --attach for every screenshot and video, then screenshot markdown rewritten to <img … width="720"> so they are reasonably large on GitHub. Videos stay as GitHub player embeds. Never leave unhosted local paths as the reviewer-visible proof.
  • gh ≥ 2.99 with push access (gh pr comment --help lists --attach)
  • Project onboarded (/rn-dev-agent:setup or $rn-dev-agent:setup)
  • iOS: Xcode + a simulator runtime
  • Android emulator: Android SDK + AVD
  • Physical: USB debugging, exclusive claim, exact serial
  • Pin-cache maestro-runner >= 1.1.24

This command runs the rn-pr-qa protocol inline in the parent session (GH #31).