asc Plugin

Fast, scriptable CLI for the App Store Connect API. Automate TestFlight, builds, submissions, signing, analytics, screenshots, subscriptions, and more. JSON-first, no interactive prompts.

Commands

Authentication

• asc auth login — Authenticate with App Store Connect API
• asc auth status — Check authentication status
• asc auth doctor — Validate authentication configuration

App Management

• asc apps list — List all apps

Utility

• asc self version — Print asc version
• asc _ _ — Passthrough to asc CLI

Usage Examples

• "List all apps in App Store Connect"
• "Authenticate with App Store Connect API"
• "Check authentication status"
• "List TestFlight builds"
• "Submit app for review"

Installation

brew install asc

Or via install script (macOS/Linux):

curl -fsSL https://asccli.sh/install | bash

Examples

# Authenticate with API keys
asc auth login \
  --name "MyApp" \
  --key-id "ABC123" \
  --issuer-id "DEF456" \
  --private-key /path/to/AuthKey.p8 \
  --network

# Authenticate for CI (bypass keychain)
asc auth login \
  --bypass-keychain \
  --name "MyCIKey" \
  --key-id "ABC123" \
  --issuer-id "DEF456" \
  --private-key /path/to/AuthKey.p8

# Validate authentication
asc auth status --validate
asc auth doctor

# List apps
asc apps list
asc apps list --output table
asc apps list --output json --pretty

# Set default output format
export ASC_DEFAULT_OUTPUT=markdown

# Any asc command with passthrough
asc _ _ testflight list
asc _ _ builds list --app-id "com.example.app"

Key Features

• JSON-first design — Non-interactive, scriptable output by default
• TTY-aware output — Automatically chooses table for terminals, JSON for pipes/CI
• No interactive prompts — Designed for CI/CD and automation
• Comprehensive coverage — TestFlight, builds, submissions, signing, analytics, screenshots, subscriptions
• Stability labels — Visible lifecycle labels (experimental, DEPRECATED) for CI confidence
• Config-backed auth — Bypass keychain for CI environments
• Fast performance — Optimized for speed in automated workflows
• 147 releases — Active development with frequent updates

Common Workflows

• TestFlight feedback and crashes — Manage beta testing and crash reports
• Builds and distribution — Handle build uploads and distribution
• Release management — High-level App Store publish flow
• Review status — Check app review status and blockers
• Metadata — Manage app metadata and localization
• Screenshots and media — Upload and manage screenshots
• Signing and bundle IDs — Manage code signing and bundle identifiers
• Workflow automation — End-to-end CI/CD workflows
• Xcode integration — Verified local Xcode to TestFlight workflow

Notes

• API keys must be generated at https://appstoreconnect.apple.com/access/integrations/api
• Use --bypass-keychain for CI environments where keychain access is unavailable
• Output format defaults: table for TTY, json for non-TTY (pipes/files/CI)
• Set ASC_DEFAULT_OUTPUT environment variable for global preference
• Stability labels indicate command maturity: no label = stable, [experimental] = evolving, DEPRECATED = migration path
• Commands with no stability label are suitable for production CI use