rorkai /App-Store-Connect-CLI

Fast, scriptable CLI for the App Store Connect API. Automate TestFlight, builds, submissions, signing, analytics, screenshots, subscriptions, and more

★ 8,357⑂ 732👁 16⑃ 3,221● 585▤ 261
GoMITCreated 2026-01-20asccli.sh
Download: 6.6.16.6.1 ↓6.6.12026-11-11
+8
Daily
8,357
stars
732
forks
16
watchers
3,221
prs
585
issues
261
releases

README

App Store Connect CLI


  
  
  
  
  



  


A fast, lightweight, and scriptable CLI for the App Store Connect API.
Automate iOS, macOS, tvOS, and visionOS release workflows from your terminal, IDE, or CI/CD pipeline.


  
    
      
      
    
  


 Table of Contents

- asc skills
- Quick Start
- Troubleshooting
- Privacy and telemetry
- Support
- Wall of Apps
- Common Workflows
- Commands and Reference
- Documentation
- Acknowledgements
- Contributing
- License

 asc skills

Agent Skills for automating asc workflows including builds, TestFlight, metadata sync, submissions, and signing:
https://github.com/rorkai/app-store-connect-cli-skills

Install them globally so they are available across projects:

bash
asc install-skills


The command installs the 25 skills from pinned, reviewed commit
f52c4f04323bb2dfb21ca8be82e6494e9cd0b4d8 and requires only git; it runs no Node.js, npx, npm package, or repository script. See
Agent skills for what it verifies and changes.

 Quick Start

If you want to confirm the binary works before configuring authentication:

bash
asc version
asc --help


 1. Install

bash
 Homebrew (recommended)
brew install asc

 Install script (macOS/Linux)
curl -fsSL https://asccli.sh/install | bash


powershell
 Windows (WinGet, once the package is accepted)
winget install asc

 Exact fallback when scripting
winget install --id Rorkai.ASC --exact


The WinGet package is tracked in
GitHub Discussion 1552.
Until it appears in winget search asc, Windows users can download the
release binaries directly from the
GitHub releases page.

With Nix:

bash
 Run without installing
nix run github:rorkai/App-Store-Connect-CLI -- --version

 Install into your profile
nix profile install github:rorkai/App-Store-Connect-CLI


The flake builds the latest source on main.

For source builds and contributor setup, see CONTRIBUTING.md.
Released binaries are self-contained and do not require a Go installation;
source builds use the toolchain version declared by go.mod.
Releases built with Go 1.27 require macOS 13 Ventura or later. On older Macs,
retain an older compatible release or upgrade macOS before updating asc.

 2. Authenticate

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


Individual API keys have no issuer ID. Omit --issuer-id and pass --key-type individual:

bash
asc auth login \
  --name "MyIndividualKey" \
  --key-id "ABC123" \
  --key-type individual \
  --private-key /path/to/AuthKey.p8


Generate API keys at:
https://appstoreconnect.apple.com/access/integrations/api

If a service holds the private key and signs App Store Connect tokens for you, set ASC_BEARER_TOKEN to such a token instead of configuring a key; asc sends it until it expires (Apple's maximum is 20 minutes). For longer runs, set ASC_BEARER_TOKEN_COMMAND to a command that prints a new token, and asc renews the token before it expires. See Authentication.

If you are running in CI,

Discussions

Latest release

6.6.1 6.6.1 2026-11-11
What's Changed
 apps wall: add Now Planner by @ChangJoo-Park in https://github.com/rorkai/App-Store-Connect-CLI/pull/3468
 fix(telemetry): skip the production collector for unstamped builds by @rudrankriyam in https://github.com/rorkai/App-Store-Connect-CLI/pull/3469
 fix(screenshots): validate alpha, and run every validate check before uploading by @LevanKvirkvelia in https://github.com/rorkai/App-Store-Connect-CLI/pull/3476
 apps wall: add Accounted: Net Worth Tracker by @charles830918 in https://github.com/rorkai/App-Store-Connect-CLI/pull/3470
 apps wall: add Atomic: Learn Languages by @ch

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON