asc-cli

asc-cli

App Store Command Center — inspired by the Terran Command Center from StarCraft.

A CLI for App Store Connect — automate builds, releases, TestFlight, subscriptions, and screenshots from your terminal or CI pipeline. Outputs structured JSON so AI agents can drive the full release workflow.

Quick Start

You need an App Store Connect API key (create one here).

brew install asccli

asc auth login \
  --key-id YOUR_KEY_ID \
  --issuer-id YOUR_ISSUER_ID \
  --private-key-path ~/.asc/AuthKey_XXXXXX.p8

asc apps list          # find your app ID
asc init --app-id <id> # pin it — skip --app-id on every future command

Multiple accounts, environment variables for CI: auth. Building from source: CONTRIBUTING.md.

Built for Agents: CAEOAS

REST has HATEOAS — responses embed URLs so clients navigate without knowing the API. asc has CAEOAS (Commands As the Engine Of Application State): every response embeds ready-to-run commands, so an agent navigates without memorising the command tree.

// asc versions list --app-id app-abc
{
  "id": "v1",
  "versionString": "2.1.0",
  "state": "PREPARE_FOR_SUBMISSION",
  "isEditable": true,
  "affordances": {
    "listLocalizations": "asc version-localizations list --version-id v1",
    "checkReadiness":    "asc versions check-readiness --version-id v1",
    "submitForReview":   "asc versions submit --version-id v1"  // only when isEditable == true
  }
}

JSON is the default; add --output table or --output markdown for people, or run asc tui to browse interactively. asc web-server serves the same commands as a REST API. More in docs/design.md.

What It Covers

Area	What you can do
Apps & Versions	Set the app’s price or make it free, create versions, link builds, pre-flight checks, submit for review — with first-time IAPs and subscriptions in the same submission → pricing · readiness · submit with products · review submissions
Builds	Archive Xcode projects, export IPA/PKG, upload, set encryption compliance → archive · upload
TestFlight	Beta groups, testers (CSV import/export), beta review, per-locale beta app description → testflight · beta review · beta localizations
Metadata	What’s New, description, keywords; name, subtitle, privacy policy; categories; age rating; review contact → version localizations · app info · age rating · review detail
Screenshots & Previews	Upload once to the asset library and place on every localization; legacy screenshot and preview sets → asset library · screenshots · previews
App Shots	AI screenshot generation: templates, gallery sets, plugin themes, Gemini enhancement → app shots · themes
Monetization	IAPs, subscriptions, intro/promotional/win-back offers, offer codes, per-territory pricing, promoted purchases, availability → IAP & subscriptions · promoted purchases · availability
Product Page Optimization	A/B test your product page with alternate icons → experiments
Code Signing	Bundle IDs, certificates, devices, provisioning profiles → code signing
Customer Reviews	Read reviews and respond → reviews
Team	Members, roles, invitations → users
Xcode Cloud	Products, workflows, start and inspect builds → xcode cloud
Insights	Sales, finance and analytics reports; performance metrics and diagnostics → reports · performance
App Clips & Game Center	App Clip experiences; achievements and leaderboards → app clips · game center
Iris (private API)	Web-UI features with no public API: create apps, read App Review’s rejection messages → iris · resolution center
Extend	Plugins, skills, local simulators, REST server → plugins · skills · simulators · REST API

Every feature, one line each: docs index. Every command and flag: command reference or asc <command> --help.

More

• Release workflow — upload → TestFlight → submit, end to end
• Use as a Swift package — embed ASCKit in your own tool
• Contributing — build, test, and where things go
• Changelog

Sponsors

Apps that use and support asc-cli development:

AppNexus for App Store Connect

App Wall

Apps built and published using asc-cli. To add yours, edit homepage/apps.json and open a pull request — see docs/features/app-wall/README.md for the format. View the live wall at asccli.app/#app-wall.

License

Apache License 2.0. See LICENSE and NOTICE.