Testflight

TestFlight & App Store Connect

Query TestFlight feedback, beta testers, builds, and beta groups via the App Store Connect API using a bundled script.

Prerequisites

Three environment variables must be available (typically from Doppler via direnv). The canonical APPLE_ASC_* names are preferred; the legacy APPLE_APP_STORE_CONNECT_* names are still accepted as a fallback.

If missing, prompt the user to add them to Doppler and run direnv allow.

Usage

The bundled script scripts/appstore-connect.sh handles JWT generation and API calls.

Available Commands

# TestFlight feedback (default)
bash ${SKILL_DIR}/scripts/appstore-connect.sh <bundle-id> feedback

# List beta testers
bash ${SKILL_DIR}/scripts/appstore-connect.sh <bundle-id> testers

# Recent builds
bash ${SKILL_DIR}/scripts/appstore-connect.sh <bundle-id> builds

# Beta groups
bash ${SKILL_DIR}/scripts/appstore-connect.sh <bundle-id> groups

# Raw API query (any App Store Connect endpoint path)
bash ${SKILL_DIR}/scripts/appstore-connect.sh <bundle-id> raw /v1/apps/{appId}/betaAppLocalizations

Bundle IDs

Look up the bundle ID from the project's iOS config. Common locations:

• Flutter: ios/Runner.xcodeproj/project.pbxproj or ios/Runner/Info.plist
• Xcode: target > General > Bundle Identifier
• If unknown, run with any bundle ID — the script lists available apps on auth errors

Workflow

1. Verify env vars are set: check APPLE_APP_STORE_CONNECT_API_KEY_ID exists in environment
2. Determine the bundle ID from project config
3. Run the appropriate command via the bundled script
4. Parse and present the JSON output to the user in a readable format

Interpreting Results

• feedback: Returns screenshotSubmissions and crashSubmissions arrays from Apple's v1 beta feedback endpoints. Screenshot submissions include tester comments, device info, and screenshot URLs (with expiration dates). Crash submissions include crash logs.
• testers: Email, name, invite type, device info, and installed build version for all beta testers.
• builds: Version, upload date, processing state, and expiration status.
• groups: Beta group names, whether internal, and public link status.

Error Handling

Additional Resources

Reference Files

• references/api-endpoints.md — Full App Store Connect API endpoint reference for TestFlight-related resources, field descriptions, and filter parameters

Scripts

• scripts/appstore-connect.sh — Bundled query script with JWT generation, multi-command support, and error handling. Prefers python3 with PyJWT for reliable ES256 JWT signing; falls back to openssl with DER-to-raw signature conversion. Requires curl, jq, and either python3 + pyjwt or openssl + base64 + xxd.