asc

name	asc
description	Use this skill when the user wants to automate iOS app deployment, manage TestFlight, handle builds and submissions, manage App Store Connect API, or work with iOS app store operations.

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