app-store-connect

# App Store Connect (asc CLI)

Router skill. The `asc` CLI covers the full surface area of App Store Connect. Read the sub-skill that matches the task.

## Sub-skills

| Sub-skill | Use when |
|-----------|---------|
| `release-flow` | Uploading a build, distributing to TestFlight, or submitting to App Store review |
| `crash-triage` | Triaging TestFlight crashes and beta feedback |
| `shots-pipeline` | Automated screenshot capture + frame + upload |
| `metadata-sync` | Bulk metadata sync and legacy format migration |
| `localize-metadata` | Translating metadata to multiple languages |
| `signing-setup` | Onboarding a new app or rotating signing assets |
| `submission-health` | Preflight checks before submission |
| `testflight-orchestration` | Complex TF group / tester management |
| `ppp-pricing` | Territory-specific / PPP pricing |
| `revenuecat-catalog-sync` | Syncing ASC subs with RevenueCat |
| `xcode-build` | Building / archiving with xcodebuild |
| `notarization` | macOS Developer ID notarization |
| `subscription-localization` | Bulk-localizing subscription display names |
| `app-create-ui` | Creating a new app record (no public API, browser automation) |
| `workflow` | Multi-step asc workflow automations |
| `wall-submit` | Submitting to the Wall of Apps |
| `build-lifecycle` | Tracking build processing, finding latest builds, cleaning old builds |
| `id-resolver` | Resolving IDs (apps, builds, groups) from human-friendly names |
| `cli-usage` | asc CLI flags, output formats, pagination, auth, and discovery |

## Capability Map

| Area | Commands |
|------|----------|
| **Release** | `asc publish`, `asc submit`, `asc release` |
| **TestFlight** | `asc testflight`, `asc builds`, `asc build-localizations` |
| **Metadata** | `asc metadata`, `asc localizations`, `asc versions`, `asc app-info` |
| **Screenshots** | `asc screenshots`, `asc video-previews` |
| **Signing** | `asc signing`, `asc certificates`, `asc profiles`, `asc bundle-ids` |
| **Subscriptions / IAP** | `asc subscriptions`, `asc iap` |
| **Pricing** | `asc pricing` |
| **Analytics** | `asc analytics`, `asc insights`, `asc performance` |
| **Users** | `asc users`, `asc devices` |
| **Notarization** | `asc notarization` |
| **Workflows** | `asc workflow` |
| **Status** | `asc status --app <APP_ID>` |

Always run `asc <subcommand> --help` to verify flags. Output: `--output table` for humans, default JSON for scripts.

## Direct API fallback when `asc` is unavailable

If `asc` is not installed or not on PATH, use the App Store Connect API directly with credentials from `~/.asc/config.json` and the private key path in that config. This is especially useful for read-only metadata checks.

```python
import json, time, urllib.request, os, jwt
cfg = json.load(open(os.path.expanduser('~/.asc/config.json')))
key_path = os.path.expanduser(cfg.get('key_path') or cfg.get('private_key_path') or os.environ.get('ASC_PRIVATE_KEY_PATH', '~/.asc/AuthKey.p8'))
key = open(key_path).read()
token = jwt.encode(
    {'iss': cfg['issuer_id'], 'exp': int(time.time()) + 1200, 'aud': 'appstoreconnect-v1'},
    key,
    algorithm='ES256',
    headers={'kid': cfg['key_id'], 'typ': 'JWT'},
)
base = 'https://api.appstoreconnect.apple.com/v1'
def get(path):
    req = urllib.request.Request(base + path, headers={'Authorization': 'Bearer ' + token})
    return json.load(urllib.request.urlopen(req, timeout=30))
```

Useful read-only paths:
- Resolve app: `/apps?filter[bundleId]=$BUNDLE_ID&limit=1`
- Versions: `/apps/{app_id}/appStoreVersions?filter[platform]=IOS&limit=10`
- Version localization, includes `description`, `keywords`, `promotionalText`, `whatsNew`: `/appStoreVersions/{version_id}/appStoreVersionLocalizations?limit=200`
- App info: `/apps/{app_id}/appInfos?limit=10`
- App info localization, includes `name`, `subtitle`, privacy URLs: `/appInfos/{app_info_id}/appInfoLocalizations?limit=200`