M
Melvynx
#App Store Connect#iOS deployment#CLI automation

Automate App Store Connect with asc CLI and NowStack Mobile AI Agents

Learn to automate iOS app deployment, TestFlight, releases, screenshots, and metadata management using the asc CLI and NowStack Mobile AI agents. This guide covers API key setup, boilerplate usage, and automated workflows for efficient mobile development.

5 min readAI Guide

Introduction

Introduction
asc (Automate App Store Connect) is a fast, scriptable CLI tool that enables developers to ship iOS applications directly from their terminal in minutes. It automates critical tasks like TestFlight builds, releases, metadata management, and signing, significantly streamlining the iOS app deployment workflow.

Configuration Checklist

Element Version / Link
Language / Runtime Go (for asc), JavaScript/TypeScript (for NowStack Mobile)
Main library asc CLI, NowStack Mobile boilerplate
Required APIs App Store Connect API
Keys / credentials needed App Store Connect API Key (Key ID, Issuer ID, Private Key)

Step-by-Step Guide

Step 1 — Automating App Store Connect with asc

asc is a command-line interface (CLI) that simplifies interactions with App Store Connect and Apple Ads. It allows developers to automate various tasks, from shipping apps to managing metadata and inspecting API schemas, all from a single Go binary.

To install asc, you can use Homebrew or a direct install script:

# Install via Homebrew
brew install asc

# Or via install script
curl -fSL https://asccli.sh/install | bash

Step 2 — Setting up App Store Connect API Key

To allow asc or AI agents to interact with App Store Connect, you need to create an API key. This key provides secure access without requiring your Apple ID and password.

  1. Navigate to Users and Access in App Store Connect.
  2. Go to the Integrations tab, then App Store Connect API.
  3. Generate a new API key with Admin access.
  4. Note down the Key ID, Issuer ID, and download the private key file (.p8).

To log in via the terminal using asc:

asc auth login --name "MyKey" --key-id "ABC123" --issuer-id "DEF456" --private-key /path/to/AuthKey.p8
# --name: A friendly name for your key
# --key-id: The Key ID generated in App Store Connect
# --issuer-id: The Issuer ID from App Store Connect
# --private-key: Path to your downloaded .p8 private key file
# Optional flags:
# --key-type individual (default: team)
# --bypass-keychain: Store credentials in config.json instead of keychain (default: false)
# --local: Add --local to write to ./.asc/config.json for the current repo.
# --network: Validate credentials with a lightweight API request
# --skip-validation: Skip JMT and network validation checks (default: false)

Step 3 — Introducing NowStack Mobile Boilerplate

Step 3 — Introducing NowStack Mobile Boilerplate
NowStack Mobile is a boilerplate project designed to accelerate mobile app development by integrating various tools and AI agents. It includes a structured agents folder with predefined skills (commands) to automate common development and deployment tasks.

nowstack-mobile/
├── agents/
│   └── skills/
│       ├── ns-add-documentation
│       ├── ns-android-distribute
│       ├── ns-architecture
│       ├── ns-clean
│       ├── ns-create-app
│       ├── ns-deploy-android-app
│       ├── ns-doctor
│       ├── ns-find-asc-credentials # Skill to find App Store Connect credentials
│       ├── ns-generate-store-screenshots # Skill to generate store screenshots
│       ├── ns-images # Skill to upload and generate images
│       ├── ns-insights
│       ├── ns-ios-audit # Skill to audit iOS app for deployment rules
│       ├── ns-ios-distribute # Magic skill to handle full iOS distribution
│       ├── ns-ios-testflight # Skill to deploy to TestFlight
│       ├── ns-ios-verification # Skill to verify iOS app functionality
│       ├── ns-publish-to-production
│       ├── ns-release
│       ├── ns-setup-accounts
│       ├── ns-setup-admin # Skill to set up admin users
│       ├── ns-setup-auth
│       ├── ns-setup-stripe
│       └── ... (many more skills)
├── mobile-app/
├── web-app/
└── ...

Step 4 — Deploying iOS Apps with NowStack Mobile Agents

NowStack Mobile agents can automate the entire iOS deployment pipeline. After setting up your App Store Connect API key, you can use specific skills to audit, distribute, and manage your app.

# Find App Store Connect credentials (launches browser for login)
./ns-find-asc-credentials

# Audit your iOS application for compliance with deployment rules
./ns-ios-audit

# Distribute your iOS application (magic skill that handles everything)
./ns-ios-distribute

# Generate and upload all necessary images/screenshots
./ns-images

# Deploy a version to TestFlight
./ns-ios-testflight

# Verify the application's functionality
./ns-ios-verification

Step 5 — Running the NowStack Mobile Application Locally

To develop and test your NowStack Mobile application locally, you can use a single command that launches the Convex backend, web app, and mobile app simultaneously.

pnpm start-all-ios
# This command will:
# - Start Convex (backend services)
# - Start the web application
# - Start the mobile application (iOS simulator)
# All logs are stored in the 'logs' folder for AI agent analysis.

Step 6 — Admin Panel and User Management

NowStack Mobile includes an interactive admin platform that allows you to manage users and debug your application. This platform is automatically deployed with your site.

To set an admin user via the terminal:

./ns-set-admin http://localhost:3100/api/app melvynmal@gmail.com
# This command sets the specified email as an admin for the local deployment.
# It allows access to the interactive admin platform to manage users and data.

Step 7 — Automating App Store Metadata and In-App Purchases

Step 7 — Automating App Store Metadata and In-App Purchases
NowStack Mobile agents can pre-fill and manage all App Store metadata, including promotional text, descriptions, keywords, and marketing URLs. They can also handle in-app purchases and subscriptions, automating the tedious process of setting up products and pricing.

This automation ensures that all required information is correctly submitted to App Store Connect, including screenshots and in-app purchase details, significantly reducing manual effort and potential errors.

Comparison Tables

Agent-Burn CLI Usage Summary (AI Models)

Model Cost (USD) Tokens (Millions) Percentage
claude-opus-4-8 $1476.39 38.0 38.0%
claude-table-5 $1154.88 29.7 29.7%
gpt-5.5 $1890.50 33.5 33.5%
claude-sonnet-4-6 $135.46 0.3 0.3%
claude-haiku-4-5-20251001 $8.85 0.0 0.0%
gpt-5.4-mini $3.69 0.0 0.0%
Total $31.4 1.0 100.0%

Note: The video shows a summary of AI model usage and associated costs for a specific period, highlighting the efficiency and cost-effectiveness of different models in development tasks.

⚠️ Common Mistakes & Pitfalls

  1. Incorrect App Store Connect API Key Setup: Ensure the Key ID, Issuer ID, and private key file are correctly generated and provided during asc auth login. Incorrect credentials will prevent automation.
  2. Missing Permissions for AI Agents: When using AI agents like NowStack Mobile, verify that the generated API key has the necessary Admin access rights in App Store Connect to perform all required tasks (e.g., uploading builds, managing metadata, setting up in-app purchases).
  3. Manual App Store Connect Interface Interaction: The primary goal of asc and NowStack Mobile is to eliminate manual interaction with the App Store Connect web interface. Relying on manual steps defeats the purpose of automation and can lead to inconsistencies or delays.
  4. Outdated Boilerplate/Dependencies: Keep the NowStack Mobile boilerplate and its dependencies updated. Outdated versions can lead to build failures or compatibility issues with the latest iOS versions or App Store Connect requirements.
  5. Incomplete Metadata/Screenshot Generation: While AI agents automate much of this, always review the generated metadata and screenshots before final submission to ensure they accurately represent your app and meet Apple's guidelines. [Editor's note: Verify the exact review process in the official documentation.]

Glossary

asc: A fast, scriptable command-line interface (CLI) for automating tasks related to Apple's App Store Connect and Apple Ads.
App Store Connect API: An API provided by Apple that allows developers to programmatically interact with App Store Connect to manage apps, metadata, builds, and more.
TestFlight: Apple's beta testing service that allows developers to distribute pre-release versions of their iOS, iPadOS, watchOS, tvOS, and macOS apps to testers.

Key Takeaways

  • asc CLI enables direct iOS app deployment and management from the terminal, bypassing the web interface.
  • NowStack Mobile provides a boilerplate with AI agents (skills) to automate the entire mobile app development and deployment lifecycle.
  • Automated tasks include TestFlight builds, releases, screenshot generation, metadata management, and in-app purchase setup.
  • Secure access to App Store Connect is managed via API keys, which can be set up and utilized by AI agents.
  • The boilerplate supports both mobile (iOS/Android via Expo) and web applications, sharing authentication logic.
  • An integrated admin platform allows for user management and debugging of the deployed application.
  • The use of AI agents significantly reduces manual effort, improves efficiency, and ensures consistency in app deployment processes.

Resources