Skip to main content

builds

Manage builds, uploads, processing, and TestFlight distribution
The builds command manages uploads, processing state, TestFlight distribution, and build metadata in App Store Connect.

Usage

Common subcommands

Upload builds

Upload an IPA or PKG to App Store Connect:

List builds

List builds for an app and filter by version, build number, or processing state:

Inspect build details

Resolve a build directly by ID or by app context:

Wait for processing

Distribute to TestFlight groups

Expire builds

Common workflows

Upload and distribute the latest build

Inspect the latest iOS build for a version

Useful flags

string
required
App Store Connect app ID, bundle ID, or exact app name
string
Path to an .ipa file for iOS, tvOS, or visionOS uploads
string
Path to a .pkg file for macOS uploads
string
Filter or target a marketing version string (CFBundleShortVersionString)
string
Filter or target a specific build number (CFBundleVersion)
string
Filter by processing state: VALID, PROCESSING, FAILED, INVALID, or all
boolean
Resolve the latest matching build in an app-scoped selector

TestFlight command

Manage TestFlight groups, testers, feedback, and review flows

TestFlight guide

Complete TestFlight distribution guide