termio-sh / asc
Drive App Store Connect from the terminal with the `asc` CLI — TestFlight builds, groups, testers and What to Test notes; App Store versions, metadata, keywords, screenshots and release notes; submissions and review health; signing, provisioning and notarization; crash and beta-feedback triage; pricing, subscriptions and Apple Ads. Use whenever the task touches App Store Connect, TestFlight, an App Store release or submission, or an iOS/macOS build upload. Route to the matching file under references/ before running commands.
asc — App Store Connect from the CLI
asc is installed via Homebrew (brew install asc). It is the only tool that
should touch App Store Connect here — do not hand-roll JWTs or curl the API.
This skill is a router. Read the one reference that matches the task, not the
whole set. Each reference is a self-contained playbook with the exact commands.
Before anything
Every command needs credentials. Check first:
asc auth status # active profile
asc doctor # diagnose a broken or missing setupIf nothing is stored, register a key (Key ID + Issuer ID + .p8 from
https://appstoreconnect.apple.com/access/integrations/api):
asc auth login --name <label> --key-id <KEY_ID> --issuer-id <UUID> \
--private-key <path/to/AuthKey_XXXX.p8> --networkMost commands need an app or build ID rather than a name — seereferences/asc-id-resolver.md.
Routing table
| Task | Read |
|---|---|
Flags, output formats, pagination, discovery — how to shape any asc command | references/asc-cli-usage.md |
| Turn an app / build / version / group / tester name into an ID | references/asc-id-resolver.md |
| TestFlight groups, testers, distribution, What to Test notes | references/asc-testflight-orchestration.md |
| Build processing status, finding the latest build, retention cleanup | references/asc-build-lifecycle.md |
| TestFlight crashes, beta feedback, hangs, launch diagnostics | references/asc-crash-triage.md |
| Build, archive, export, bump version/build numbers, upload an IPA/PKG | references/asc-xcode-build.md |
| Stage a version, publish, submit for review | references/asc-release-flow.md |
| Validation failures, stuck submissions, cancel and retry decisions | references/asc-submission-health.md |
| Pull, edit, validate and apply App Store metadata and keywords | references/asc-metadata-sync.md |
| Write release notes (What's New) from git log or bullets | references/asc-whats-new-writer.md |
| Translate metadata into more locales | references/asc-localize-metadata.md |
| Offline ASO / keyword audit of pulled metadata | references/asc-aso-audit.md |
| Capture, frame and upload screenshots (simulator pipeline) | references/asc-shots-pipeline.md |
| Fix screenshot dimensions, alpha channels, validation errors | references/asc-screenshot-resize.md |
| Bundle IDs, capabilities, certificates, provisioning profiles | references/asc-signing-setup.md |
| Developer ID signing + notarization for distribution outside the App Store | references/asc-notarization.md |
| Territory-specific / PPP pricing | references/asc-ppp-pricing.md |
| Subscription and IAP display names across locales | references/asc-subscription-localization.md |
| Reconcile the ASC catalog with RevenueCat | references/asc-revenuecat-catalog-sync.md |
| Apple Ads campaigns, ad groups, keywords, reports | references/asc-apple-ads.md |
Repo-local multi-step automations (.asc/workflow.json) | references/asc-workflow.md |
| Create a new app record (browser automation — no public API) | references/asc-app-create-ui.md |
| Submit an entry to the asc Wall of Apps | references/asc-wall-submit.md |
References cross-name each other by their old skill names — a line saying
"route to asc-submission-health" means references/asc-submission-health.md
in this skill.
Provenance
Vendored from https://github.com/rorkai/app-store-connect-cli-skills at the
commit asc install-skills pins (recorded per file in skills-lock.json).
Upstream ships these as 23 separate top-level skills; here they are flattened
into this one skill's references/, with each skill's own references/ folder
nested under references/<skill-name>/ and its links rewritten to match. The
prose is otherwise verbatim — do not hand-edit it. To update, runasc install-skills, then re-flatten from ~/.agents/skills/asc-* and delete
the global copies.