asc-cli

Manage App Store Connect operations including TestFlight builds, releases, and reviews via the asc CLI.

1|Updated Jun 20, 2026
One-click install
npx skills add https://github.com/riipandi/minis-skills --skill asc-cli-riipandi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: asc-cli
Source: https://github.com/riipandi/minis-skills/tree/main/asc-cli
Command: npx skills add https://github.com/riipandi/minis-skills --skill asc-cli-riipandi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing iOS and macOS app distribution through the App Store Connect web UI is slow and repetitive. This Skill lets you perform TestFlight beta distribution, App Store submissions, release management, and review monitoring directly from the command line using the asc CLI. ## Core Features & Use Cases - TestFlight Management: List builds and beta groups, publish builds to public testers with release notes, and inspect tester metrics and crash logs. - App Store Release Workflow: Stage new versions, copy metadata between versions, manage localizations (e.g., en-US, zh-Hans), validate readiness, submit for review, and release after approval. - Auth & Diagnostics: Guided setup of App Store Connect API keys (.p8) with keychain-bypass login for iSH environments, plus auth status validation. - Use Case: You just uploaded build 42 and want it live for public testers. Ask to publish the build to your beta group with test notes, then check crash submissions a day later — all without opening a browser. ## Quick Start Ask the assistant to list your App Store Connect apps and publish the latest build to your public TestFlight group with release notes.

Frequently Asked Questions about asc-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a build to TestFlight from the command line?

Use asc publish testflight with the app ID, build ID, beta group ID, test notes, and locale, adding --submit --confirm to submit for beta review. First list builds and groups with asc builds list and asc testflight groups list to get the required IDs.

How to submit an iOS app for App Store review using a CLI?

Stage the version with asc release stage, update localizations and what's-new text, validate with asc validate, then run asc review submit with the app ID, version, and build ID. After approval, release manually with asc versions release.

How do I set up App Store Connect API key authentication?

Generate an API key in App Store Connect under Users and Access > Integrations > API Keys, then download the .p8 file. Run asc auth login with your key ID, issuer ID, and private key path, using --bypass-keychain on systems without a keychain like iSH.

Does asc work on iSH or Alpine Linux?

Yes, install the prebuilt linux_arm64 binary from the GitHub Releases page into /usr/local/bin. Since iSH has no system keychain, use --bypass-keychain during login and store the config and .p8 key under /root/ for persistence.

Why does asc auth fail after restarting iSH?

Files stored in /tmp are wiped on iSH restart, so credentials placed there are lost. Keep the config at /root/.asc/config.json and the private key at /root/AuthKey_*.p8, then verify with asc auth status --validate.

Can I get per-build download counts from TestFlight?

No, the Apple API only returns cumulative tester-level metrics, not real-time per-build download or install counts. Crash submissions also lack build numbers, so filter them by upload timestamp instead.