Changelog

Release history and changes for the App Store Connect CLI

Release Information

The App Store Connect CLI follows semantic versioning. All releases are available on GitHub: https://github.com/rudrankriyam/App-Store-Connect-CLI/releases

Latest Releases

Unreleased

No unreleased changes yet.

1.1.1

Highlights:

Metadata keyword validation now counts characters instead of UTF-8 bytes, fixing false failures for Arabic, Japanese, and other non-English scripts
Screenshot upload helper regressions are covered by focused shared-flow tests so screenshot-set upload behavior is less likely to break silently
The Wall of Apps adds Imposter Game: Fakeout Party, QontactR, RateTier, and SweatCount - Workout Calendar

Changes:

fix(metadata): Validate metadata and localization keywords by characters across shared keyword validation flows
test(assets): Add regression coverage for the shared screenshot set upload helper
build(community): Add Imposter Game: Fakeout Party, QontactR, RateTier, and SweatCount - Workout Calendar to the Wall of Apps

1.1.0

Highlights:

Screenshot automation is much stronger with localization fan-out uploads, resumable artifact flows, and preflight validation before large screenshot runs
Metadata and localization workflows are easier to audit and scale with keyword audit tooling, bulk localization apply support, supported-locale discovery, and byte-aware keyword validation
App Store release workflows are more reliable with publish dry-run planning, validate remediation guidance, tougher review-state handling, and broader territory normalization across pricing surfaces

Changes:

feat(screenshots): Add screenshot upload fan-out, resumable upload artifacts, and screenshot validate preflight coverage
feat(metadata): Add metadata keywords audit, tighten keyword push validation, and preserve partial-apply diagnostics
feat(localizations): Add bulk localizations apply, supported-locale discovery, and stronger locale/create warning handling
feat(validate): Add remediation guidance and stricter validate/reporting coverage for release readiness flows
feat(publish): Add dry-run planning for publish appstore and relax dry-run auth preflight requirements
fix(pricing): Retry price equalization updates after rate limiting and normalize territory inputs consistently across pricing commands
fix(reviews): Preserve unknown review lookup errors and tighten stale submission handling

1.0.1

Highlights:

Metadata and localization write failures now surface the attempted field names alongside Apple’s generic (-50) errors, making App Store Connect rejections much easier to debug
Review screenshot create coverage now catches failed delivery verification for both in-app purchases and subscription groups before regressions can slip into release CI
The Wall of Apps and install badge pick up the latest community refresh with DeskTally and HoverCalc

Changes:

fix(metadata): Include attempted metadata field names in generic App Store Connect write failures
fix(localizations): Preserve whitespace-only attempted-field context so localization update diagnostics match the outgoing request
test(cmdtest): Add failed delivery verification coverage for IAP and subscription review screenshot create commands
build(community): Refresh the installs badge and add DeskTally and HoverCalc to the Wall of Apps

1.0.0

Highlights:

App Store Connect CLI 1.0 removes deprecated commands and aliases across the CLI so the canonical command tree is the only supported surface
Runtime migration guidance now points removed compatibility paths to their 1.0 replacements, including publishing, release, submit, age-rating, and build flows
The Mintlify docs now include a dedicated migration guide and refreshed command pages for the 1.0 command taxonomy

Changes:

feat(cli): Remove deprecated commands, aliases, and compatibility wrappers for the 1.0 release
feat(cli): Standardize canonical view and edit command surfaces and keep removed-path migration guidance for key workflows
docs: Add a dedicated migrate-to-1.0 guide and refresh command docs to match the 1.0 CLI
test(cli): Update command-surface coverage and runtime migration tests for removed commands and aliases

0.49.1

Highlights:

ASC Studio is more reliable after fixing app-selection, refresh, and sheet timing races
The website/docs are more stable with repaired command-reference coverage and Mintlify scroll behavior
App tags and release workflows are documented more clearly, and the Wall of Apps picks up new showcase entries

Changes:

fix(studio): Resolve app-selection, refresh, and sheet race conditions in ASC Studio
docs: Refresh stale command reference pages and add release, status, release-notes, screenshots plan/apply, and app-tags coverage
fix(docs): Prevent Studio CSS from breaking Mintlify scrolling and repair main-branch docs CI gaps
docs: Clarify Apple-generated app-tag discoverability surfaces in CLI help and website docs
build(branding): Rename the product surfaces to App Store Connect CLI and ASC Studio
feat(apps-wall): Add Daily Self Care - Anicca, Tintz: Color Picker, Blimber - Student Planner, Telescopo: Markdown & Diagrams, and iCardSort

0.49.0

Highlights:

asc publish appstore is now the canonical App Store shipping command with clearer upgrade guidance from the older release and submit compatibility paths
Local-build publishing can now upload an IPA through App Store Connect directly and carry that build through the App Store release flow from the CLI
Review, screenshots, IAPs, and subscriptions are easier to automate with additive planning commands and stable selector resolution

Changes:

feat(publish): Add local-build publish mode with App Store Connect API uploads
feat(publish): Make asc publish appstore the canonical App Store publish path and simplify deprecated publishing guidance
feat(reviews): Split additive review metadata and screenshot planning workflows into clearer command surfaces
feat(selectors): Add stable selector resolution for in-app purchases and subscriptions
fix(validate): Refresh validate-subscriptions request contexts more eagerly to avoid timeout-related flakes

0.48.1

Highlights:

Product page optimization treatment localizations now support screenshot-set upload and sync commands
Windows private key permission checks are fixed for more reliable auth/setup workflows
Release guardrails are more stable after tightening a flaky mutating-request timeout test

Changes:

feat(product-pages): Add product page optimization treatment localization screenshot-set upload and sync commands
fix(windows): Correct private key permission checks on Windows
test(release): Stabilize the mutating request timeout refresh assertion used by release CI

0.48.0

Highlights:

asc validate is now the canonical App Store submission readiness report with broader checks and clearer upgrade guidance from the legacy preflight compatibility command
Pricing workflows are easier to inspect with asc pricing current and more reliable current-price pagination/filtering
Subscription introductory offers can now be created in bulk from CSV with shared defaults and row-level overrides

Changes:

feat(validate): Make asc validate the canonical App Store submission readiness command and deprecate the legacy preflight compatibility wrapper
feat(pricing): Add asc pricing current for current app price lookup with territory filtering
fix(pricing): Preserve pricing query params while paginating and tighten current-price territory behavior
feat(subscriptions): Add CSV import for subscription introductory offers with inherited defaults, row overrides, dry-run summaries, and stronger validation
feat(web): Add a false-only regulated medical-device declaration command for experimental web-session workflows
fix(output): Display human-readable platform names in table and markdown output
fix(testflight): Reject conflicting --group and --build-id beta tester selectors consistently
fix(game-center): Handle missing Game Center detail lists without crashing
fix(subscriptions): Improve subscription import preflight validation

0.47.1

Highlights:

Improved high-level release and submission workflow reliability
Better status/watch behavior and review submission summaries
Expanded docs, release guardrails, and CI hardening for the new website split

Changes:

feat(release): Split shared release submission behavior across release, publish, submit, and status flows
fix(status): Preserve watch timeout semantics while treating clean watch deadlines as expected exits
fix(status): Summarize review submissions per platform and keep bounded watch polling consistent
fix(submit): Preserve shared flow reuse semantics and surface preparation messaging more clearly
fix(publish): Honor explicit submit timeout budgets while preserving default pipeline timeouts
build(ci): Split CI, hook, and release hardening for docs-aware checks
docs: Split help taxonomy and recover Mintlify website content and workflows

v0.36.3

Highlights:

Fixed PKG upload UTI to use com.apple.pkg
Added subcategory flags to categories set command
Enhanced app-info locale validation and metadata copying

Changes:

fix(builds): Use com.apple.pkg for PKG upload UTI
feat(categories): Add subcategory flags to categories set command
fix(app-info): Preserve target fields when copying locale metadata
refactor(app-info): Reuse localization attribute builder
refactor(submit): Simplify readiness missing-field allocation

v0.36.2

Highlights:

Improved metadata push workflow with state-aware version resolution
Fixed build pagination anomaly detection

Changes:

refactor(metadata): Include state in shared version resolution
fix(builds): Detect repeated probe links before early-stop path
fix(builds): Use strict uploadedDate for anomaly detection

v0.36.1

Highlights:

Enhanced build processing reliability
Fixed pagination edge cases

Changes:

fix(builds): Error when anomaly scan hits page cap
fix(builds): Fail on repeated probe pagination URLs
fix(builds): Continue scanning after ordering anomaly detection
fix(builds): Propagate context cancellation during probe pages

v0.36.0

Highlights:

Major build processing improvements
Performance optimizations for large build lists

Changes:

fix(builds): Preserve latest response links and sync docs defaults
fix(builds): Keep latest result when probe page fetch fails
fix(builds): Avoid exhaustive latest-build pagination scans
fix(builds): Compare uploadedDate by parsed time across pre-release versions

v0.35.3

Highlights:

CLI consistency improvements
Enhanced app events validation

Changes:

fix(auth): Respect global default output for auth status
refactor(cli): Standardize usage errors and pagination loops
fix(app-events): Align purchase requirement messaging with supported values
fix(app-events): Normalize purchase requirement and guard unsupported values

v0.35.2

Highlights:

Subscription pricing fixes

Changes:

fix(subscriptions): Honor initial-price attributes and fail on probe errors

Previous Releases

For a complete release history, see:

GitHub Releases: https://github.com/rudrankriyam/App-Store-Connect-CLI/releases
Git Tags: https://github.com/rudrankriyam/App-Store-Connect-CLI/tags

Viewing Releases

Via GitHub

View all releases with detailed release notes:

open https://github.com/rudrankriyam/App-Store-Connect-CLI/releases

Via Git

List recent tags:

git tag --sort=-v:refname | head -10

View changes between releases:

git log v0.36.2..v0.36.3 --oneline

Via CLI

Check your current version:

asc version

Upgrading

Homebrew

If installed via Homebrew:

brew upgrade asc

Install Script

If installed via install script, re-run:

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

From Source

Pull latest changes and rebuild:

git pull origin main
make build

Versioning Policy

The CLI follows Semantic Versioning:

Major version (x.0.0): Breaking changes, incompatible API updates
Minor version (0.x.0): New features, backward-compatible additions
Patch version (0.0.x): Bug fixes, backward-compatible improvements

Deprecation Policy

When features are deprecated:

Warning added: Command/flag shows deprecation notice
Migration path provided: Documentation updated with alternatives
Grace period: Feature remains available for at least one minor version
Removal: Deprecated feature removed in next major version

Breaking Changes

Breaking changes are documented in release notes and migration guides. Check release notes before upgrading major versions.

Release Channels

Stable

Recommended for production use. Install via Homebrew or install script.

brew install asc

Main Branch

Latest development version. May include unreleased features and fixes.

git clone https://github.com/rudrankriyam/App-Store-Connect-CLI.git
cd App-Store-Connect-CLI
make build

Note: Main branch is tested but may have unreleased changes. Use stable releases for production.

Changelog Format

Release notes follow this structure:

## [Version] - YYYY-MM-DD

### Added
- New features

### Changed
- Changes to existing functionality

### Deprecated
- Soon-to-be removed features

### Removed
- Removed features

### Fixed
- Bug fixes

### Security
- Security improvements

Commit Message Conventions

Commits follow Conventional Commits:

feat: - New feature
fix: - Bug fix
refactor: - Code refactoring
test: - Test additions/changes
docs: - Documentation changes
chore: - Maintenance tasks
perf: - Performance improvements

Example:

feat(builds): add PKG upload support

fix(auth): respect global default output

refactor(cli): standardize pagination loops

Notable Changes by Category

Authentication

JWT token auto-renewal (all versions)
Keychain bypass mode (ASC_BYPASS_KEYCHAIN)
Strict auth mode for conflict detection (ASC_STRICT_AUTH)
Base64 key support for CI/CD

Builds & Uploads

PKG upload UTI fix (v0.36.3)
Build pagination improvements (v0.36.x)
Upload timeout configuration
Progress tracking for large files

API Integration

Automatic retry logic for rate limits
Retry-After header support
Configurable timeouts and delays
Debug mode for HTTP logging (ASC_DEBUG=api)

Output & Formatting

TTY-aware output defaults
JSON, table, and markdown formats
Global output preference (ASC_DEFAULT_OUTPUT)
Pretty-print option for JSON

Testing & Development

Keychain bypass for tests
Integration test opt-in
Pre-commit hooks
Command doc generation

Reporting Issues

Found a bug or regression? Report it:

GitHub Issues: https://github.com/rudrankriyam/App-Store-Connect-CLI/issues
Security Issues: https://github.com/rudrankriyam/App-Store-Connect-CLI/security/advisories/new (private reporting)

Include:

CLI version (asc version)
Platform and architecture
Command run (sanitize sensitive data)
Expected vs actual behavior
Full error output (use ASC_DEBUG=api for details)

Stay Updated

Watch Releases

Watch the repository for release notifications:

Go to https://github.com/rudrankriyam/App-Store-Connect-CLI
Click “Watch” → “Custom” → “Releases”

RSS Feed

Subscribe to releases via RSS:

https://github.com/rudrankriyam/App-Store-Connect-CLI/releases.atom

Star History

View project growth:

Contributing

Contributions are welcome! See the Contributing Guide for details on:

Development setup
Testing requirements
PR guidelines
Local validation

All changes are documented in release notes and git history.

Resources

​Changelog

​Release Information

​Latest Releases

​Unreleased

​1.1.1

​1.1.0

​1.0.1

​1.0.0

​0.49.1

​0.49.0

​0.48.1

​0.48.0

​0.47.1

​v0.36.3

​v0.36.2

​v0.36.1

​v0.36.0

​v0.35.3

​v0.35.2

​Previous Releases

​Viewing Releases

​Via GitHub

​Via Git

​Via CLI

​Upgrading

​Homebrew

​Install Script

​From Source

​Versioning Policy

​Deprecation Policy

​Breaking Changes

​Release Channels

​Stable

​Main Branch

​Changelog Format

​Commit Message Conventions

​Notable Changes by Category

​Authentication

​Builds & Uploads

​API Integration

​Output & Formatting

​Testing & Development

​Reporting Issues

​Stay Updated

​Watch Releases

​RSS Feed

​Star History

​Contributing

Changelog

Release Information

Latest Releases

Unreleased

1.1.1

1.1.0

1.0.1

1.0.0

0.49.1

0.49.0

0.48.1

0.48.0

0.47.1

v0.36.3

v0.36.2

v0.36.1

v0.36.0

v0.35.3

v0.35.2

Previous Releases

Viewing Releases

Via GitHub

Via Git

Via CLI

Upgrading

Homebrew

Install Script

From Source

Versioning Policy

Deprecation Policy

Breaking Changes

Release Channels

Stable

Main Branch

Changelog Format

Commit Message Conventions

Notable Changes by Category

Authentication

Builds & Uploads

API Integration

Output & Formatting

Testing & Development

Reporting Issues

Stay Updated

Watch Releases

RSS Feed

Star History

Contributing