Release Information
The App Store Connect CLI follows semantic versioning. All releases are available on GitHub: https://github.com/rudrankriyam/App-Store-Connect-CLI/releasesLatest Releases
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
fix(builds): Usecom.apple.pkgfor PKG upload UTIfeat(categories): Add subcategory flags to categories set commandfix(app-info): Preserve target fields when copying locale metadatarefactor(app-info): Reuse localization attribute builderrefactor(submit): Simplify readiness missing-field allocation
v0.36.2
Highlights:- Improved metadata push workflow with state-aware version resolution
- Fixed build pagination anomaly detection
refactor(metadata): Include state in shared version resolutionfix(builds): Detect repeated probe links before early-stop pathfix(builds): Use strict uploadedDate for anomaly detection
v0.36.1
Highlights:- Enhanced build processing reliability
- Fixed pagination edge cases
fix(builds): Error when anomaly scan hits page capfix(builds): Fail on repeated probe pagination URLsfix(builds): Continue scanning after ordering anomaly detectionfix(builds): Propagate context cancellation during probe pages
v0.36.0
Highlights:- Major build processing improvements
- Performance optimizations for large build lists
fix(builds): Preserve latest response links and sync docs defaultsfix(builds): Keep latest result when probe page fetch failsfix(builds): Avoid exhaustive latest-build pagination scansfix(builds): Compare uploadedDate by parsed time across pre-release versions
v0.35.3
Highlights:- CLI consistency improvements
- Enhanced app events validation
fix(auth): Respect global default output for auth statusrefactor(cli): Standardize usage errors and pagination loopsfix(app-events): Align purchase requirement messaging with supported valuesfix(app-events): Normalize purchase requirement and guard unsupported values
v0.35.2
Highlights:- Subscription pricing fixes
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:Via Git
List recent tags:Via CLI
Check your current version:Upgrading
Homebrew
If installed via Homebrew:Install Script
If installed via install script, re-run:From Source
Pull latest changes and rebuild: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.Main Branch
Latest development version. May include unreleased features and fixes.Changelog Format
Release notes follow this structure:Commit Message Conventions
Commits follow Conventional Commits:feat:- New featurefix:- Bug fixrefactor:- Code refactoringtest:- Test additions/changesdocs:- Documentation changeschore:- Maintenance tasksperf:- Performance improvements
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)
- CLI version (
asc version) - Platform and architecture
- Command run (sanitize sensitive data)
- Expected vs actual behavior
- Full error output (use
ASC_DEBUG=apifor 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:Star History
View project growth:Contributing
Contributions are welcome! See the Contributing Guide for details on:- Development setup
- Testing requirements
- PR guidelines
- Local validation
