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
+8
日增长
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
#3400Your AGENTS.md is one of the best in a study of 3,000 repos0 comments · 2026-11-07#1706ASC Manager — a native macOS UI built on top of asc0 comments · 2026-06-29#1664Call from typescript: any typescipt lib available ?0 comments · 2026-06-18#1663config with react-native1 comments · 2026-06-18#1607Unlock keychain (from a ssh session)1 comments · 2026-06-02#1561How to auth on another team and switch between teams ?1 comments · 2026-05-24#1552Publish on winget for windows3 comments · 2026-05-21#1469Expected handling of publishing for "Whats New" metadata3 comments · 2026-04-28
Latest release
6.6.1 6.6.1 2026-11-11What'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