ASC CLI (App Store Connect CLI) 5.13.0: latest version, changes and gotchas

Latest: ASC CLI 5.13.0, released 2026-10-07 00:02 UTC (release notes).

Last verified 2026-10-07 against 5.13.0. Page updated 2026-10-07 12:39 UTC. Also as Markdown and JSON.

The latest ASC CLI (asc, rorkai/App-Store-Connect-CLI) is 5.13.0, released 2026-10-07 00:02 UTC. Upgrade with brew update && brew upgrade asc or the install script, then check asc --version. Since 5.12.0 it added 24 commands, mostly Asset Library video, lifecycle and placement commands, and it now rejects PNGs with an alpha channel before reserving an upload.

How do I install or upgrade to ASC CLI 5.13.0?

Homebrew (macOS, Linux):

brew update && brew upgrade asc
asc --version   # 5.13.0 (commit: 3f0b499, date: 2026-10-07T06:00:33+09:00)

Install script (macOS, Linux; use it when Homebrew lags the GitHub release):

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

Windows:

winget install --id Rorkai.ASC --exact

Pinned Linux binary with checksum check (what our sandbox ran):

V=5.13.0
curl -fsSLO https://github.com/rorkai/App-Store-Connect-CLI/releases/download/$V/asc_${V}_linux_amd64
curl -fsSLO https://github.com/rorkai/App-Store-Connect-CLI/releases/download/$V/asc_${V}_checksums.txt
grep linux_amd64 asc_${V}_checksums.txt | sha256sum -c -   # asc_5.13.0_linux_amd64: OK
install -m755 asc_${V}_linux_amd64 /usr/local/bin/asc

ASC CLI key facts

Latest release: 5.13.0 on 2026-10-07 00:02 UTC; before it 5.12.1 (2026-10-06 12:25 UTC), 5.12.0 (2026-10-06 03:38 UTC), 5.11.0 (2026-10-05 23:31 UTC) and 5.10.0 (2026-10-04 16:08 UTC).
The project shipped 8 releases in October 2026 up to 2026-10-07, 15 in September and 29 in August (GitHub releases API).
asc 5.13.0 has 1,994 help pages (commands and subcommands) in our sandbox snapshot, up from 1,935 in 5.9.2.
MIT licence, 7,685 GitHub stars on 2026-10-07; asc install-skills installs a pack of 25 agent skills.
Apple's OpenAPI 4.5.1, synced into asc 5.13.0, lists IPHONE_DUO only as an Asset Library display class; the screenshot (ScreenshotDisplayType) and preview (PreviewType) enums still have no iPhone Duo value, although asc accepts APP_IPHONE_DUO and IPHONE_DUO.
Since 5.13.0 PNG uploads with an alpha channel fail locally (exit 1 or 2) before authentication or any upload reservation.

What changed in the last 5 ASC CLI releases?

ASC CLI 5.13.0 (2026-10-07 00:02 UTC)

New asc asset-library videos upload --library-id ID --file video.mp4, and --category CREATIVE_ASSETS|APP_SCREENSHOTS_AND_PREVIEWS on image and video uploads. Video upload needs ffprobe on PATH. (source)
Asset Library image and video lifecycle: rename, archive, unarchive, delete, videos view, videos placements, videos set-poster-frame; archive and delete require --confirm. (source)
Reuse library media in version, custom product page, treatment and in-app event localizations: placements swap, placements reorder, placements delete --placement-ids, --placement-group, --video-id. (source)
asset-library images|videos list gains --category, --state, --spec-id, --reference-name, --id and --sort; none combine with --next. (source)
PNG screenshots and Asset Library images with an alpha channel are rejected before an upload is reserved. (source)
IPHONE_DUO app previews (886×1920 and 1920×886) now pass validation in metadata push and Fastlane migration. (source)
Bundled App Store Connect OpenAPI snapshot synced to Apple's 4.5.1 (28 paths, 66 schemas and 33 indexed operations added). (source)
Windows Credential Manager profiles are no longer deleted by the macOS legacy-keychain migration. (source)

ASC CLI 5.12.1 (2026-10-06 12:25 UTC)

asset-library images upload stops polling when Apple reports FAILED and prints a partial receipt with the image ID, instead of waiting for the upload timeout. (source)
asc review items add accepts --item-type appAssetLibraryImages and appAssetLibraryVideos for standalone asset review; Apple requires an approved app version first. (source)

ASC CLI 5.12.0 (2026-10-06 03:38 UTC)

iPhone Duo screenshots: APP_IPHONE_DUO at 1398×2034, 2034×1398, 2007×2853 and 2853×2007. (source)
iPhone Duo app previews: IPHONE_DUO at 1920×886 and 886×1920. (source)
New asc asset-library group: view, images list|view|upload|placements, videos list, specs. (source)
New asc localizations placements list|create|delete for product page header and search placements. (source)
asc product-pages experiments treatments create --v2 creates treatments for v2 experiments. (source)

ASC CLI 5.11.0 (2026-10-05 23:31 UTC)

Group flags placed before a subcommand are rejected (for example asc builds --app 123 list), with a hint listing the subcommands that accept the flag. (source)
asc migrate import --check-remote inspects remote store asset changes during dry runs. (source)
Network failures are classified as such and wait timeouts keep their cause. (source)
--read-only now also refuses signing sync git push and xcodebuild direct upload. (source)

ASC CLI 5.10.0 (2026-10-04 16:08 UTC)

New asc storekit reads for the App Store Server API: transactions, orders, refunds, subscriptions status, notifications, groups. (source)
asc versions attach-build selects builds with --build-number or --latest and can --wait. (source)
asc status --until waits for release outcomes and suggests nextCommands. (source)
IAP and subscription version localizations import from a JSON file (... versions localizations import). (source)

Which ASC CLI commands and flags were added or removed?

ASC CLI 5.12.1 → 5.13.0

24 commands added, 0 removed, 7 commands with flags added or removed; 17 help pages changed in any way.

Method: bin/tool-snapshot ran --help for every asc subcommand of both versions in a throwaway Linux sandbox (1970 and 1994 help pages), then bin/tool-diff compared them. Hidden flags do not appear in --help.

Commands added:

asc app-events localizations placements
asc app-events localizations placements create
asc app-events localizations placements delete
asc app-events localizations placements list
asc app-events localizations placements swap
asc asset-library images archive
asc asset-library images delete
asc asset-library images rename
asc asset-library images unarchive
asc asset-library videos archive
asc asset-library videos delete
asc asset-library videos placements
asc asset-library videos rename
asc asset-library videos set-poster-frame
asc asset-library videos unarchive
asc asset-library videos upload
asc asset-library videos view
asc localizations placements reorder
asc localizations placements swap
asc product-pages custom-pages localizations placements create
asc product-pages custom-pages localizations placements delete
asc product-pages custom-pages localizations placements reorder
asc product-pages custom-pages localizations placements swap
asc product-pages experiments treatments localizations placements

Command	Flags added	Flags removed
`asc asset-library images list`	`--category--id--reference-name--sort--spec-id--state`	none
`asc asset-library images upload`	`--category`	none
`asc asset-library videos list`	`--category--id--reference-name--sort--spec-id--state`	none
`asc localizations placements create`	`--placement-group--video-id`	none
`asc localizations placements delete`	`--placement-ids`	none
`asc localizations placements list`	`--placement-group`	none
`asc product-pages custom-pages localizations placements list`	`--placement-group`	none

Video upload and the lifecycle commands need 5.13.0; in 5.12.x asc asset-library videos upload fails with `unknown command`.

ASC CLI 5.12.0 → 5.12.1

0 commands added, 0 removed, 0 commands with flags added or removed; 8 help pages changed in any way.

Method: bin/tool-snapshot ran --help for every asc subcommand of both versions in a throwaway Linux sandbox (1970 and 1970 help pages), then bin/tool-diff compared them. Hidden flags do not appear in --help.

No command or flag changed; the help text of asc review items add and related review commands now lists appAssetLibraryImages and appAssetLibraryVideos as item types.

ASC CLI 5.11.0 → 5.12.0

16 commands added, 0 removed, 1 commands with flags added or removed; 5 help pages changed in any way.

Method: bin/tool-snapshot ran --help for every asc subcommand of both versions in a throwaway Linux sandbox (1954 and 1970 help pages), then bin/tool-diff compared them. Hidden flags do not appear in --help.

Commands added:

asc asset-library
asc asset-library images
asc asset-library images list
asc asset-library images placements
asc asset-library images upload
asc asset-library images view
asc asset-library specs
asc asset-library videos
asc asset-library videos list
asc asset-library view
asc localizations placements
asc localizations placements create
asc localizations placements delete
asc localizations placements list
asc product-pages custom-pages localizations placements
asc product-pages custom-pages localizations placements list

Command	Flags added	Flags removed
`asc product-pages experiments treatments create`	`--v2`	none

ASC CLI 5.10.0 → 5.11.0

0 commands added, 0 removed, 3 commands with flags added or removed; 42 help pages changed in any way.

Method: bin/tool-snapshot ran --help for every asc subcommand of both versions in a throwaway Linux sandbox (1954 and 1954 help pages), then bin/tool-diff compared them. Hidden flags do not appear in --help.

Command	Flags added	Flags removed
`asc migrate import`	`--check-remote`	none
`asc testflight groups delete`	`--output--pretty`	none
`asc testflight groups remove-testers`	`--output--pretty`	none

5.11.0 was mostly error-handling fixes: 42 help pages changed wording without new commands.

ASC CLI 5.9.2 → 5.10.0

19 commands added, 0 removed, 3 commands with flags added or removed; 8 help pages changed in any way.

Method: bin/tool-snapshot ran --help for every asc subcommand of both versions in a throwaway Linux sandbox (1935 and 1954 help pages), then bin/tool-diff compared them. Hidden flags do not appear in --help.

Commands added:

asc iap versions localizations import
asc storekit groups
asc storekit groups list
asc storekit groups members
asc storekit notifications
asc storekit notifications history
asc storekit notifications test
asc storekit notifications test-status
asc storekit orders
asc storekit orders lookup
asc storekit refunds
asc storekit refunds history
asc storekit subscriptions
asc storekit subscriptions status
asc storekit transactions
asc storekit transactions history
asc storekit transactions view
asc subscriptions groups versions localizations import
asc subscriptions versions localizations import

Command	Flags added	Flags removed
`asc review submit`	`--build-number--latest--poll-interval--timeout--wait`	none
`asc status`	`--timeout--until`	none
`asc versions attach-build`	`--app--build-number--latest--platform--poll-interval--timeout--version--wait`	none

What breaks when upgrading ASC CLI, and how do I migrate?

Version	Change	Migration
5.13.0	PNG screenshots and Asset Library images that carry an alpha channel (even fully opaque RGBA) fail locally before upload.	Re-export as RGB PNG or JPEG without alpha, as the error message says.
5.11.0	Group-level flags before a subcommand (`asc builds --app 123 list`) now fail with `unknown flag`.	Put flags after the leaf command: `asc builds list --app 123`.
5.0.0	Every deprecated flag alias was removed and fails with ``unknown flag` `(exit 2): for example` --build `on about 45 build-selecting commands,` --newest`/`--app-id `on` builds`,` --two-factor-code `on every` web `command,` --password `on` signing sync push\|pull`. The API 4.4.1 product-scoped` iap localizations\|images\|submit `and` subscriptions localizations\|images` commands are gone.	`--build` → `--build-id`; use the version-scoped IAP and subscription commands; signing sync passwords via `--password-file` or `ASC_SIGNING_SYNC_PASSWORD`. The project's `Migrate to 5.0` page lists every replacement.
5.0.0	Former warnings became errors: `auth logout` needs `--confirm`; `signing fetch --device` and `signing sync push --device` need `--create-missing`; app-scoped `--build-number` needs `--platform` (no longer defaults to `IOS`).	Add `--confirm`, `--create-missing` or `--platform IOS` explicitly.

What ASC CLI errors did we reproduce, and how do I fix them?

Opaque RGBA PNG rejected as having an alpha channel (ASC CLI 5.13.0)

asc screenshots upload --version-localization LOC_123 --path ./duo-rgba.png --device-type IPHONE_DUO
# duo-rgba.png: 1398x2034, PNG colour type 6, every alpha byte 255

Error: screenshots upload: "./duo-rgba.png": image has an alpha channel or transparency; re-export it as RGB PNG or JPEG without alpha
# exit 1 (asc 5.12.0 got past this check and stopped at authentication instead, exit 3)

Fix: Export without alpha (RGB PNG or JPEG). The check runs before authentication, so it fails the same way in CI with or without credentials. asset-library images upload --file prints --file: image has an alpha channel or transparency; ... with exit 2. (source)

Wrong screenshot size for iPhone Duo (ASC CLI 5.13.0)

asc screenshots upload --version-localization LOC_123 --path ./wrong-size.png --device-type IPHONE_DUO

Error: screenshots upload: screenshot "./wrong-size.png" has unsupported size 1000x1000 for APP_IPHONE_DUO (allowed: 1398x2034, 2007x2853, 2034x1398, 2853x2007). See "asc screenshots sizes --display-type APP_IPHONE_DUO".
# exit 1

Fix: Use one of the four Duo sizes; asc screenshots sizes --display-type IPHONE_DUO --output json prints them offline (same output in 5.12.0 and 5.13.0). (source)

Asset Library video upload needs ffprobe (ASC CLI 5.13.0)

asc asset-library videos upload --library-id LIB_123 --file ./duo.mp4 --category APP_SCREENSHOTS_AND_PREVIEWS

Error: asset-library videos upload: ffprobe is required; install FFmpeg and put ffprobe on PATH
# exit 2. In 5.12.0 the command does not exist: Error: unknown command `asc asset-library videos upload`

Fix: Install FFmpeg (brew install ffmpeg, apt-get install ffmpeg) so ffprobe is on PATH, and upgrade to 5.13.0 or later. (source)

List filters and --sort cannot be combined with --next (ASC CLI 5.13.0)

asc asset-library images list --next "https://api.appstoreconnect.apple.com/v1/appAssetLibraries/LIB_123/images?cursor=abc" --sort referenceName

Error: asset-library: --next cannot be combined with --sort
# exit 2

Fix: Pass filters and --sort on the first request only (or use --paginate); the links.next URL already carries them. (source)

Flag placed on the command group instead of the subcommand (ASC CLI 5.13.0)

asc builds --app 123 list

Error: unknown flag `--app` for `asc builds`
Did you mean a subcommand? These accept `--app`: list, count, next-build-number, wait, info, expire, expire-all, upload, update, add-groups, remove-groups, dsyms
For help:
  asc builds --help
# exit 2

Fix: Move the flag after the subcommand: asc builds list --app 123. (source)

No credentials in a fresh CI runner or sandbox (ASC CLI 5.13.0)

asc screenshots upload --version-localization LOC_123 --path ./duo-rgb.png --device-type IPHONE_DUO

Error: screenshots upload: missing authentication. Run 'asc auth login' or create /root/.asc/config.json (see 'asc auth init')
Hint: Run `asc auth status` to see configured credentials. To add an API key, create one at https://appstoreconnect.apple.com/access/integrations/api and run `asc auth login --name MyKey --key-id KEY_ID --issuer-id ISSUER_ID --private-key /path/to/AuthKey_KEY_ID.p8` (or set ASC_KEY_ID/ASC_ISSUER_ID/ASC_PRIVATE_KEY_PATH).
# exit 3

Fix: Set ASC_KEY_ID, ASC_ISSUER_ID and ASC_PRIVATE_KEY_PATH (the hint's own list) in the runner's secrets. Local checks (size, alpha) run before this error, so a file that passes them reaches the auth step. (source)

ASC CLI release history by month

2026-10: 5.9.0 to 5.13.0 (8 releases to 2026-10-07)

5.12.0 to 5.13.0: iPhone Duo screenshots and previews, Asset Library uploads, lifecycle and placements, OpenAPI 4.5.1. (source)
5.10.0: asc storekit App Store Server API reads. (source)
5.9.0: validate requires iPad screenshots for builds that run on iPad. (source)

2026-09: 5.0.0 to 5.8.1 (15 releases)

5.0.0 (2026-09-06) removed every deprecated flag alias and command; see the breaking changes table. (source)
5.7.0 added global read-only mode (--read-only, ASC_READ_ONLY=1), @env: and @file: flag values, and asc api raw requests. (source)
5.4.0 and 5.5.0 added suggestions for unknown subcommands and flags. (source)

2026-08: 3.4.0 to 4.11.0 (29 releases)

4.0.0 (2026-08-11) added asc xcode build and a TestFlight upload-only publish mode. (source)
4.11.0 added deep submission validation. (source)

2026-07: 2.5.1 to 3.3.0 (14 releases)

3.0.0 (2026-07-16) built only the selected command tree for faster startup and clarified unknown-flag errors. (source)

2026-06: 1.9.0 to 2.5.0 (12 releases)

2.0.0 (2026-06-10) removed deprecated commands and updated the bundled OpenAPI snapshot to App Store Connect API 4.4. (source)
2.5.0 added nested review items commands and idempotent IAP and subscription localization create. (source)

2026-05: 1.2.8 to 1.8.0 (14 releases)

1.5.0 (2026-05-18) added asc search for agent-oriented command discovery and batch customer review replies. (source)

Sources

rorkai/App-Store-Connect-CLI releases (GitHub API) (read 2026-10-07)
ASC CLI 5.13.0 release notes (read 2026-10-07)
ASC CLI 5.12.1 release notes (read 2026-10-07)
ASC CLI 5.12.0 release notes (read 2026-10-07)
ASC CLI 5.11.0 release notes (read 2026-10-07)
ASC CLI 5.10.0 release notes (read 2026-10-07)
PR 2943: sync official App Store Connect OpenAPI 4.5.1 (read 2026-10-07)
OpenAPI snapshot in asc 5.13.0 (docs/openapi/latest.json) (read 2026-10-07)
PR 2938: reject App Store image alpha before reserving uploads (read 2026-10-07)
PR 2939: reusable Asset Library video uploads and media categories (read 2026-10-07)
PR 2404: remove every CLI-side deprecation for 5.0.0 (read 2026-10-07)
ASC CLI README at 5.13.0 (install, upgrade, skills) (read 2026-10-07)
rorkai/App-Store-Connect-CLI repository (stars, licence) (read 2026-10-07)

Last verified: 2026-10-07.