Repolode
Submit
rorkai

rorkai/App-Store-Connect-CLI

A fast, scriptable command-line tool for the App Store Connect API to automate iOS, macOS, tvOS and visionOS releases.

View on GitHubWebsite
Stars
7,979
Forks
681
Open issues
5
Last commit
17 hours ago

What is it?

asc is a command-line client for Apple's App Store Connect API. It lets developers script release tasks such as uploading builds, managing TestFlight groups and feedback, submitting apps for review, updating metadata and screenshots, and checking review status, all from a terminal, IDE or CI/CD pipeline.

Beyond App Store Connect itself, the CLI covers code signing (fetching certificates and provisioning profiles, syncing signing identities through an encrypted store), local Xcode build and archive helpers, and Xcode Cloud run management. It also includes commands for subscriptions, analytics, StoreKit server APIs, and Apple Ads campaign reporting.

Output defaults to a table in interactive terminals and JSON in pipes and CI, with explicit flags for table, JSON or Markdown. Authentication uses App Store Connect API keys, stored in the macOS Keychain or in a config file for headless environments. The project is written in Go, distributed through Homebrew and an install script, and is not affiliated with Apple.

Key features

  • 01Upload builds and manage TestFlight groups, feedback and crash logs
  • 02Submit apps for review and check review status and blockers
  • 03Manage metadata, localizations and screenshots from local files
  • 04Fetch and sync code signing certificates and provisioning profiles
  • 05Call any App Store Connect endpoint directly with the raw API command
  • 06Outputs table, JSON or Markdown, with JSON chosen by default in CI

Use cases

  • Uploading and distributing iOS or macOS builds to TestFlight from CI
  • Scripting App Store submissions with a version bump and metadata sync
  • Pulling crash logs and tester feedback into a terminal or dashboard
  • Automating screenshot uploads across locales and device sizes

Quick start

  1. 1

    Install with Homebrew

    brew install asc
  2. 2

    Confirm the binary works

    asc version
  3. 3

    Authenticate with your App Store Connect API key

    asc auth login --name "MyApp" --key-id "ABC123" --issuer-id "DEF456" --private-key /path/to/AuthKey.p8 --network
  4. 4

    List your apps

    asc apps list --output table

Things to know

  • Requires an App Store Connect API key from your Apple developer account to do anything useful.
  • Releases built with Go 1.27 require macOS 13 Ventura or later.
  • Enables anonymous command-level usage telemetry by default, which you must disable if unwanted.

Topics

#app-store-connect#ios#testflight#cli#cicd#xcode#automation#apple#command-line-tool#developer-tools

FAQ

What is App-Store-Connect-CLI?
A fast, scriptable command-line tool for the App Store Connect API to automate iOS, macOS, tvOS and visionOS releases. asc is a command-line client for Apple's App Store Connect API. It lets developers script release tasks such as uploading builds, managing TestFlight groups and feedback, submitting apps for review, updating metadata and screenshots, and checking review status, all from a terminal, IDE or CI/CD pipeline.
Is App-Store-Connect-CLI free to use? What license does it have?
App-Store-Connect-CLI is open source under the MIT license. Check the license terms before using it in commercial products.
Is App-Store-Connect-CLI still maintained?
Actively maintained. The last commit to App-Store-Connect-CLI was on Oct 19, 2026.
What can I use App-Store-Connect-CLI for?
Uploading and distributing iOS or macOS builds to TestFlight from CI Scripting App Store submissions with a version bump and metadata sync Pulling crash logs and tester feedback into a terminal or dashboard Automating screenshot uploads across locales and device sizes
How do I install App-Store-Connect-CLI?
Install with Homebrew: brew install asc Confirm the binary works: asc version Authenticate with your App Store Connect API key: asc auth login --name "MyApp" --key-id "ABC123" --issuer-id "DEF456" --private-key /path/to/AuthKey.p8 --network List your apps: asc apps list --output table
Where can I get App-Store-Connect-CLI?
The source code and installation instructions are on GitHub: https://github.com/rorkai/App-Store-Connect-CLI

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects