Skip to main content

​
App Store Connect CLI

Command-line access to the App Store Connect API for iOS, macOS, tvOS, and visionOS release work

​
App Store Connect from the command line

Run App Store Connect tasks from your terminal, IDE, or CI/CD pipeline. Manage TestFlight, builds, submissions, signing, analytics, and more.

Get StartedCommand Reference
$ asc apps list
OK Authenticated as MyApp
iOS My iOS App (123456789)
macOS My macOS App (987654321)
tvOS My tvOS App (456789123)
$ asc builds upload —app 123456789
OK Build uploaded successfully

​
Quick start

Get up and running with the App Store Connect CLI in minutes

1

Install the CLI

Install via Homebrew (recommended) or use the install script:
Homebrew
brew install asc
Install Script
curl -fsSL https://asccli.sh/install | bash
2

Authenticate with your API key

Generate an API key from App Store Connect and authenticate:
asc auth login \
  --name "MyApp" \
  --key-id "ABC123" \
  --issuer-id "DEF456" \
  --private-key /path/to/AuthKey.p8
Your credentials are securely stored in the system keychain with config/env fallback.
3

Run your first command

List your apps to verify authentication:
asc apps list --output table

ID          NAME              BUNDLE ID
123456789   My iOS App        com.example.myapp
987654321   My macOS App      com.example.macapp

​
Explore by topic

Guides for the main parts of shipping and maintaining your apps

TestFlight distribution

Manage builds, beta testers, feedback, and crash reports

App Store submission

Validate, submit, and automate your App Store release process

Code signing

Manage certificates, provisioning profiles, and bundle IDs

Metadata management

Update app info, localizations, screenshots, and preview videos

Analytics & reports

Download analytics, financial reports, and performance metrics

CI/CD integration

Integrate with GitHub Actions, GitLab CI, Bitrise, and CircleCI

​
Command reference

Browse all available commands organized by category

Apps

​
App Management

Manage apps, versions, localizations, pricing, and categories

View commands
Test

​
TestFlight & Builds

Upload builds, manage testers, view feedback and crashes

View commands
Sign

​
Code Signing

Manage certificates, provisioning profiles, and bundle IDs

View commands
Auto

​
Automation

Run workflows, webhooks, Xcode Cloud, and notifications

View commands

​
Resources

Reference pages, troubleshooting notes, and project docs

Troubleshooting

Common issues and solutions

FAQ

Frequently asked questions

Contributing

Contribute to the project

​
Start with the quickstart

Set up the CLI and run your first App Store Connect command.

Get Started