ASC CLI: Fast, Scriptable Automation for App Store Connect
ASC CLI – Fast, Scriptable Automation for App Store Connect
If you build iOS apps, you’ve probably spent hours digging through the App Store Connect web console to manage builds, TestFlight groups, or sales reports. The new ASC CLI (App‑Store‑Connect‑CLI) turns those repetitive tasks into a lightweight, script‑first tool written in Go. It’s open‑source, MIT‑licensed, and can be installed with Homebrew or built from source.
Why Use ASC CLI?
| Challenge | ASC CLI Solution |
|---|---|
| Manual work | Automate builds, releases, and feedback through the terminal |
| Heavy tooling | A single Go binary (<10 MiB) with instant startup |
| Poor scripting support | JSON‑first output, clear flag syntax, no prompts |
| CI integration | Non‑interactive, environment‑friendly, supports CI/CD pipelines |
The README and docs show more than 60 high‑level commands: asc builds, asc testflight, asc reviews, asc analytics, and even asc migrate for Fastlane compatibility. All commands default to JSON output, but you can switch to --output table or --output markdown when you need human‑readable data.
Quick Start
Homebrew (recommended)
brew tap rudrankriyam/tap
brew install rudrankriyam/tap/asc
From Source
git clone https://github.com/rudrankriyam/App-Store-Connect-CLI.git
cd App-Store-Connect-CLI
make build
sudo make install # installs to /usr/local/bin
Authentication
asc auth login \
--name "MyApp"
--key-id "ABC123"
--issuer-id "DEF456"
--private-key /path/to/AuthKey.p8
~/.asc/config.json when a keychain isn’t available.
Core Features
- Build & Version Management – List, list all, expire, and attach builds to versions. Example:
asc builds list --app 123456789 --paginate - TestFlight Automation – Add testers, manage groups, fetch feedback, and export configuration via YAML. Example:
asc testflight sync pull --app 123456789 --output testflight.yaml - App Store Metadata – Set locales, categories, pricing, and upload localizations. Example:
asc app-setup info set --app 123456789 --locale en-US --name "My Awesome App" - Analytics & Finance Reports – Download sales, finance, and detailed reports directly to TSV or CSV. Example:
asc analytics sales --vendor 12345678 --type SALES --frequency DAILY --date 2024-01-20. - Fastlane Compatibility – Import/export Fastlane metadata via
asc migratecommands. - Zero‑Interaction – Every command is flag‑driven; no interactive prompts mean it’s CI‑ready.
- Auto‑Update – When installed via the install script, ASC checks for updates on startup and auto‑updates.
Advanced Scripting Tips
- Pagination – Use
--paginateto automatically follownextlinks. - Sorting – The
--sortflag supports ascending or descending ordering. - Output Formats – Switch to table or markdown for readable reports.
- Debugging –
--debugprints verbose output;--api-debugexposes HTTP trace. - Environment Overrides – Set
ASC_KEY_ID,ASC_ISSUER_ID,ASC_PRIVATE_KEY(or base64) to skip the interactive login when running CI.
Example Workflow
# Authenticate (once)
asc auth login --name myapp --key-id ABC123 --issuer-id DEF456 --private-key ~/.keys/AuthKey.p8
# Build a new version
asc builds upload --app 123456789 --ipa path/to/app.ipa
# Attach build to a version
asc versions attach-build \
--version-id V123-456 \
--build BUILD_ID
# Submit for review
asc submit create --app 123456789 \
--version "1.5.0" \
--build BUILD_ID \
--confirm
# Retrieve submission status
asc submit status --id SUBMISSION_ID
Running this script in a CI job gives you full end‑to‑end automation without opening the App Store Connect UI.
Community & Contribution
ASC CLI is actively maintained—over 500 commits, 50 releases, and 500+ stars on GitHub. Contributions are welcome via pull requests; check the CONTRIBUTING.md for guidelines. The project relies on the open‑source community for feature requests, bug reports, and documentation improvements.
Bottom Line
ASC CLI provides a clean, version‑controlled, scriptable interface to App Store Connect that can replace manual UI steps in any development workflow. It’s ideal for teams that need repeatable, automated deployments, and for individual developers who want to avoid the web UI bottleneck.
Download, try it today, and bring the power of the terminal into your App Store Connect pipeline.