asc-testflight-orchestration

asc TestFlight orchestration

Use this skill when managing TestFlight testers, groups, and build distribution.

Export current config

• asc testflight config export --app "APP_ID" --output "./testflight.yaml"
• Include builds/testers:
  • asc testflight config export --app "APP_ID" --output "./testflight.yaml" --include-builds --include-testers

Manage groups and testers

• Groups:
  • asc testflight groups list --app "APP_ID" --paginate
  • asc testflight groups create --app "APP_ID" --name "Beta Testers"
• Testers:
  • asc testflight testers list --app "APP_ID" --paginate
  • asc testflight testers add --app "APP_ID" --email "tester@example.com" --group "Beta Testers"
  • asc testflight testers invite --app "APP_ID" --email "tester@example.com"

Distribute builds

• asc builds add-groups --build-id "BUILD_ID" --group "GROUP_ID"
• Remove from group:
  • asc builds remove-groups --build-id "BUILD_ID" --group "GROUP_ID" --confirm

Inspect a build's groups

• asc testflight groups list --build-id "BUILD_ID" --output table
• The build lookup is experimental. It resolves the app, paginates the app's groups, and includes groups with all-build access.

Upload without distribution

• asc publish testflight --app "APP_ID" --ipa "./app.ipa" --upload-only --output json
• Add --wait when the next step needs a processed build.
• Upload-only requires a new IPA or local Xcode build. Do not combine it with an existing --build-id, groups, tester notifications, test notes, or beta-review submission. --build-number is allowed as upload metadata, but it cannot be the only build input.

What to Test notes

• asc builds test-notes create --build-id "BUILD_ID" --locale "en-US" --whats-new "Test instructions"
• asc builds test-notes update --localization-id "LOCALIZATION_ID" --whats-new "Updated notes"

Notes

• Use --paginate on large groups/tester lists.
• Prefer IDs for deterministic operations; use the ID resolver skill when needed.