Swift MIT

asc-cli

App Store Connect from your terminal & Agents. A Swift CLI for managing your iOS and macOS apps on App Store Connect. Submit versions, manage screenshots, track builds — with full AI-agent support via CAEOAS affordances.

T

tddworks

Dernière activité 23 sept. 2026
tddworks/asc-cli

372

étoiles

29

forks

0

issues ouvertes

agentappstore-connectappstoreconnectasccliiapscreenshot-generatorsubscriptionsswifttestflight

Ce README est souvent en anglais.

asc-cli

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

CI codecov Swift Platform

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

Sponsors

Apps that use and support asc-cli development:

AppNexus
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.

Projets similaires

Fast, scriptable CLI for the App Store Connect API. Automate TestFlight, builds, submissions, signing, analytics, screenshots, subscriptions, and more

Goapp-store-connectappleautomation
Rrorkai
7,5 k étoiles633

Native macOS App Store Connect tool with MCP. Submit iOS apps to App Store with AI agents

Swiftapp-store-analyticsapp-store-connectapp-store-connect-api
Bblitzdotdev
1,8 k étoiles139

Skills to automate app store deployed and everything related to it using the asc cli

Pythonagent-skillsai-skillsapp-store-connect
Rrorkai
1 k étoiles63