| name | asc-cli |
| description | Use this skill for App Store Connect CLI (`asc`) usage, including install/auth setup, command families, CI/CD integration, and troubleshooting for releases, builds, TestFlight, metadata, signing, finance, and analytics workflows. |
App Store Connect CLI (asc)
Use this skill when the user asks about asc CLI command usage, automation patterns, CI/CD, or which asc command to run for a release workflow.
Quick setup
- Install
asc:
brew install asc
curl -fsSL https://asccli.sh/install | bash
- Verify installation:
asc --help
asc --version
- Authenticate:
asc auth login \
--name "MyApp" \
--key-id "ABC123" \
--issuer-id "DEF456" \
--private-key /path/to/AuthKey.p8
For Apple API credentials, generate key details at:
https://appstoreconnect.apple.com/access/integrations/api
Core command families
Use asc <command> --help for current flags and nested subcommands.
auth โ authentication and profile management.
doctor โ diagnose config/auth issues.
install-skills โ install asc skill pack for prebuilt workflows.
init โ initialize asc helper docs in repo.
docs โ open embedded documentation helpers.
analytics โ report and sales analytics.
insights โ weekly/daily insights.
finance โ financial and payout reports.
performance โ performance diagnostics.
feedback, crashes โ TestFlight feedback/crash discovery.
apps, app-info, versions, localizations โ app metadata lifecycle.
app-setup, app-tags, app-clips, android-ios-mapping โ setup and platform mappings.
screenshots, video-previews, background-assets, product-pages โ visual metadata assets.
builds, build-bundles, pre-release-versions โ binary build operations.
testflight, beta-app-localizations, beta-build-localizations, sandbox โ TestFlight workflows.
submit, validate, publish โ review/release workflows.
review, reviews โ review artifacts and customer reviews.
iap, subscriptions, offer-codes, app-events โ monetization workflows.
signing, certificates, profiles, bundle-ids, merchant-ids, pass-type-ids โ signing and identifiers.
notarization โ macOS notarization flow.
users, devices, account, actors โ team and access management.
xcode-cloud โ trigger and monitor Xcode Cloud runs.
webhooks, notify โ events and integrations.
workflow, status, metadata, diff, release-notes โ automation and planning utilities.
Common practical commands
asc apps list --output table
asc builds upload --app "123456789" --file "/path/to/MyApp.ipa"
asc validate --app "123456789" --version "1.2.3"
asc submit --app "123456789" --version "1.2.3"
- Pull TestFlight feedback and crashes:
asc feedback --app "123456789" --paginate
asc crashes --app "123456789" --sort -createdDate --limit 25
asc workflow run --file .asc/workflow.json --workflow release
Scripting and CI practices
- Use deterministic output:
--output json (default, machine-friendly, minified)
--output table|markdown for humans
--paginate to fetch all pages
- CI reporting:
--report (example junit)
--report-file to save artifacts.
- Multi-profile CI:
asc --profile production ...
- Use explicit
--app, --limit, --paginate for stable scripting.
- Auth in non-interactive CI:
- Prefer
asc auth login --name ... with secure secret handling and reuse stored profile.
Troubleshooting and useful patterns
Non-official caveat
This project is unofficial and not affiliated with Apple. Confirm risk acceptance before replacing official tooling.
Official references