Skip to main content

asc testflight

Manage TestFlight builds, beta groups, and testers.

Development Status

TestFlight commands are actively being developed. Core functionality (builds, groups, testers) is available. Advanced features like beta app review submission are planned.

Builds Commands​

builds list​

List TestFlight builds for an app.

asc testflight builds list <bundle-id>
asc testflight builds list <bundle-id> --limit 20

Arguments:

  • bundle-id - The app's bundle identifier

Options:

  • --limit, -n - Number of builds to show (default: 10)

builds expire​

Expire a TestFlight build.

asc testflight builds expire <build-id>

Groups Commands​

groups list​

List beta groups for an app.

asc testflight groups list <bundle-id>

groups create​

Create a new beta group.

asc testflight groups create <bundle-id> --name "Beta Testers"
asc testflight groups create <bundle-id> --name "Public Beta" --public

Options:

  • --name, -n - Group name (required)
  • --public - Create a public link for the group

Testers Commands​

testers list​

List beta testers for an app.

asc testflight testers list <bundle-id>

testers add​

Add a beta tester.

asc testflight testers add <bundle-id> --email user@example.com
asc testflight testers add <bundle-id> --email user@example.com --group "Beta Testers"

Options:

  • --email, -e - Tester email (required)
  • --group, -g - Beta group name to add tester to

testers remove​

Remove a beta tester.

asc testflight testers remove <bundle-id> --email user@example.com

Common Workflows​

Set Up Beta Testing​

# 1. List available builds
asc testflight builds list live.yooz.whisper

# 2. Create a beta group
asc testflight groups create live.yooz.whisper --name "Beta Testers"

# 3. Add testers
asc testflight testers add live.yooz.whisper \
  --email user1@example.com \
  --group "Beta Testers"

asc testflight testers add live.yooz.whisper \
  --email user2@example.com \
  --group "Beta Testers"

# 4. Verify
asc testflight testers list live.yooz.whisper
asc testflight groups create live.yooz.whisper \
  --name "Public Beta" \
  --public

Returns a public link that anyone can use to join testing.

Manage Build Availability​

# List builds
asc testflight builds list live.yooz.whisper --limit 5

# Expire old build
asc testflight builds expire BUILD_ID

Output Examples​

builds list​

Build     Version   Status          Uploaded
1234      1.2.0     READY_FOR_SALE  2025-01-01 10:00
1233      1.1.5     EXPIRED         2024-12-15 14:30
1232      1.1.4     EXPIRED         2024-12-01 09:15

groups list​

Name            Type       Testers  Public Link
Beta Testers    Internal   5        -
Public Beta     External   142      testflight.apple.com/...

testers list​

Email                    Name         Status    Groups
user1@example.com       John Doe      Invited   Beta Testers
user2@example.com       Jane Smith    Accepted  Beta Testers

Planned Features​

The following features are planned for future releases:

  • Beta app review submission
  • Build upload
  • Build metadata management
  • Tester metrics and analytics
  • Bulk tester import from CSV
  • Beta app localization

Learn More​