mcpField
A
asc-testflight-orchestration

asc-testflight-orchestration

github.com/rorkaiTesting & quality1.1k7.3k installsUpdated 2d ago
Repository

About asc-testflight-orchestration

A skill for using the `asc` CLI to manage TestFlight testers, groups, builds, and distribution. It covers configuration export, uploads, and build test notes.

Key features

  1. 01Export TestFlight configuration
  2. 02List and create tester groups
  3. 03Add or invite testers
  4. 04Assign builds to groups
  5. 05Upload builds without distribution
  6. 06Create and update test notes

Use cases

  1. 01Export an app's current TestFlight setup
  2. 02Invite testers to a beta group
  3. 03Distribute a build to selected groups
  4. 04Upload an IPA before deciding distribution

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rorkai/app-store-connect-cli-skills --skill asc-testflight-orchestration

After installing, type/asc-testflight-orchestrationin Claude Code to confirm it loaded.

Details

From the project README

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"
    • A group's builds and testers: asc testflight groups builds list --group-id "GROUP_ID" --paginate and asc testflight groups testers list --group-id "GROUP_ID" --paginate
  • Testers:
    • asc testflight testers list --app "APP_ID" --paginate
    • asc testflight testers add --app "APP_ID" --email "[email protected]" --group "Beta Testers"
    • asc testflight testers invite --app "APP_ID" --email "[email protected]"

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.

Comments

Markdown supported