NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #3884 most downloaded on PyPI
CLI tools used in Codemagic builds
Latest stable
0.70.2
Last release 17 days ago
29 Oct 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
89 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
Deprecations The following actions are deprecated and show a warning message when invoked:
This release contains changes from PR #386 and PR #387.
Features
app-store-connect command line API experience by gathering similar actions under respective action groups.app-store-connect bundle-ids,app-store-connect certificates,app-store-connect devices,app-store-connect profiles.Deprecations The following actions are deprecated and show a warning message when invoked:
app-store-connect list-builds (replaced by app-store-connect builds list),app-store-connect create-bundle-id (replaced by app-store-connect bundle-ids create),app-store-connect delete-bundle-id (replaced by app-store-connect bundle-ids delete),app-store-connect get-bundle-id (replaced by app-store-connect bundle-ids get),app-store-connect list-bundle-id-profiles (replaced by app-store-connect bundle-ids profiles),app-store-connect list-bundle-ids (replaced by app-store-connect bundle-ids list),app-store-connect create-certificate (replaced by app-store-connect certificates create),app-store-connect delete-certificate (replaced by app-store-connect certificates delete),app-store-connect get-certificate (replaced by app-store-connect certificates get),app-store-connect list-certificates (replaced by app-store-connect certificates list),app-store-connect list-devices (replaced by app-store-connect devices list),app-store-connect register-device (replaced by app-store-connect devices register),app-store-connect create-profile (replaced by app-store-connect profiles create),app-store-connect delete-profile (replaced by app-store-connect profiles delete),app-store-connect get-profile (replaced by app-store-connect profiles get),app-store-connect list-profiles (replaced by app-store-connect profiles list).Development
@action signature was changed. Optional keyword argument deprecated_alias: str was replaced by optional deprecation_info: ActionDeprecationInfo which holds both version in which the action was deprecated, and the deprecated name of the action.@action definition was moved from codemagic.cli.cli_app to codemagic.cli.action. It is still accessible from package codemagic.cli as before.Documentation
app-store-connect list-builds (replaced by app-store-connect builds list),app-store-connect create-bundle-id (replaced by app-store-connect bundle-ids create),app-store-connect delete-bundle-id (replaced by app-store-connect bundle-ids delete),app-store-connect get-bundle-id (replaced by app-store-connect bundle-ids get),app-store-connect list-bundle-id-profiles (replaced by app-store-connect bundle-ids profiles),app-store-connect list-bundle-ids (replaced by app-store-connect bundle-ids list),app-store-connect create-certificate (replaced by app-store-connect certificates create),app-store-connect delete-certificate (replaced by app-store-connect certificates delete),app-store-connect get-certificate (replaced by app-store-connect certificates get),app-store-connect list-certificates (replaced by app-store-connect certificates list),app-store-connect list-devices (replaced by app-store-connect devices list),app-store-connect register-device (replaced by app-store-connect devices register),app-store-connect create-profile (replaced by app-store-connect profiles create),app-store-connect delete-profile (replaced by app-store-connect profiles delete),app-store-connect get-profile (replaced by app-store-connect profiles get),app-store-connect list-profiles (replaced by app-store-connect profiles list).app-store-connect bundle-ids,app-store-connect certificates,app-store-connect devices,app-store-connect profiles.app-store-connect builds.app-store-connect builds list (used to be app-store-connect list-builds)app-store-connect bundle-ids create (used to be app-store-connect create-bundle-id)app-store-connect bundle-ids get (used to be app-store-connect get-bundle-id)app-store-connect bundle-ids list (used to be app-store-connect list-bundle-ids)app-store-connect bundle-ids profiles (used to be app-store-connect list-bundle-id-profiles)app-store-connect app-store-connect certificates create (used to be app-store-connect create-certificate)app-store-connect app-store-connect certificates delete (used to be app-store-connect delete-certificate)app-store-connect app-store-connect certificates get (used to be app-store-connect get-certificate)app-store-connect app-store-connect certificates list (used to be app-store-connect list-certificates)app-store-connect app-store-connect devices list (used to be app-store-connect list-devices)app-store-connect app-store-connect devices register (used to be app-store-connect register-device)app-store-connect app-store-connect profiles create (used to be app-store-connect create-profile)app-store-connect app-store-connect profiles delete (used to be app-store-connect delete-profile)app-store-connect app-store-connect profiles get (used to be app-store-connect get-profile)app-store-connect app-store-connect profiles list (used to be app-store-connect list-profiles)Your coding agent can read these notes before it upgrades. Set up the MCP server →
This release contains changes from PR #382
This release contains changes from PR #382
Features
app-store-connect actions get-latest-testflight-build-number, get-latest-app-store-build-number and app-store-connect get-latest-build-number in case the application has a lot of versions in App Store Connect.Development
codemagic.apple.app_store_connect.apps.Apps.list_app_store_versions_data to fetch application's App Store versions as list[dict],codemagic.apple.app_store_connect.versioning.AppStoreVersions.read_build_data to fetch build of App Store version as dict,codemagic.apple.app_store_connect.versioning.PreReleaseVersions.list_data to fetch pre-release versions as list[dict],codemagic.apple.app_store_connect.versioning.PreReleaseVersions.list_builds_data to fetch builds of pre-release version as list[dict].codemagic.tools.AppStoreConnect to dedicated classes and plug them back in as mixins.Fix error handling for invalid App Store Connect API private keys for app-store-connect actions. PR #381
Bugfixes
app-store-connect actions. PR #381This PR contains changes from PR #380
This PR contains changes from PR #380
Features
app-store-connect app-store-versions get to show App Store Version information. See official API method documentation.app-store-connect review-submission-items delete to remove existing review submission item from App Store Connect. See official API method documentation.app-store-connect review-submissions items to list review submission items of specified review submission. See official API method documentation.--locale to action app-store-connect app-store-versions localizations to filter retrieved localizations by given specified locales.app-store-connect review-submission-items create if creating review submission item fails because required values are missing for application default locale on respective App Store Version.Bugfixes
app-store-connect review-submission-items create from command line.app-store-connect create-profile when not creating development or Ad Hoc provisioning profiles.Development
codemagic.utilities.case_conversion with public functions snake_to_camel and camel_to_snake.list_items to review submissions resource manager in src/codemagic/apple/app_store_connect/versioning/review_submissions.py to retrieve submission items list from App Store Connect.AppStoreConnectError exceptions now have field api_error: Optional[ErrorResponse] to store App Store Connect API error information.Documentation
app-store-connect app-store-versions,app-store-connect review-submissions,app-store-connect review-submission-items.app-store-connect app-store-versions get,app-store-connect review-submissions items,app-store-connect review-submission-items delete.app-store-connect app-store-versions localizations,app-store-connect review-submission-items create,app-store-connect create-profile.Fail gracefully with informative error message if CLI args are passed with invalid encoding. PR #376
Bugfixes
--device-ids for action app-store-connect create-profile when not creating development or ad-hoc provisioning profiles. PR #377app-store-connect create-profile and app-store-connect fetch-signing-files). PR #377google-play actions. Capture oauth2client.client errors in Google Play API client so that the action fails gracefully with appropriate error message. PR #379Docs
--device-ids documentation for action app-store-connect create-profile. PR #377Fix handling of relative certificate path patterns for action keychain add-certificates. PR #374
Bugfixes
keychain add-certificates. PR #374Fix actions firebase-app-distribution get-latest-build-version and firebase-app-distribution releases list for cases when specified application does n
Bugfixes
firebase-app-distribution get-latest-build-version and firebase-app-distribution releases list for cases when specified application does not have any releases available. PR #373Update action xcode-project use-profiles. Fix assigning provisioning profiles to Xcode targets that have SDK specific provisioning profile specifiers.
None of the breaking changes have an effect on command line usage, only the Python API is affected.
Changes in this release are from PR #370 and add Python 3.12 compatibility.
PEP-632 deprecated distutils module, and it was removed entirely in Python 3.12. This release ensures that distutils module is not used any more.
None of the breaking changes have an effect on command line usage, only the Python API is affected.
Development
codemagic.models.Xcode.version property was changed. Instead of distutils.version.LooseVersion it is now packaging.version.Version.codemagic.models.simulator.Runtime.runtime_version property was changed. Instead of distutils.version.LooseVersion it is now packaging.version.Version.Show full executed command in error output if action execution fails unexpectedly. PR #364
Features
--verbose option is set. PR #364Bugfixes
google-play if they are defined as empty strings (--track, -tracks, --package-name, --source-track and --target-track). PR #363xcode-project build-ipa if the logs contain byte sequences that cannot be decoded. PR #365Development
codemagic.utilities.backwards_file_reader.iter_backwards. PR #365Fix Google Play release promotion with action google-play tracks promote-release for releases that have release notes. PR #361
Add new option --max-find-build-wait to action app-store-connect publish to configure maximum waiting time to discover uploaded build from App Store C
Features
--max-find-build-wait to action app-store-connect publish to configure maximum waiting time to discover uploaded build from App Store Connect before failing publishing. Defaults to 10 minutes. PR #355Docs
Support Apple Vision Pro devices in App Store Connect API read device information and list devices endpoints. This is done by declaring APPLE_VISION_P
Bugfixes
APPLE_VISION_PRO definition in enumeration codemagic.apple.resources.enums.DeviceClass. PR #357Fix initializing codemagic.models.application_package.Ipa objects for big binaries (exceeding 4GB in size). PR #356
Bugfixes
codemagic.models.application_package.Ipa objects for big binaries (exceeding 4GB in size). PR #356Ensure that build for correct platform is looked up from App Store Connect after initial upload completes using app-store-connect publish. PR #352
Bugfixes
app-store-connect publish. PR #352Additions and changes from pull request #349. Resolves issue #344.
Additions and changes from pull request #349. Resolves issue #344.
Features
--include-version to app-store-connect actions get-latest-build-number, get-latest-app-store-build-number and get-latest-testflight-build-number. If specified, the action outputs matched build's version string in addition to build number.Bugfixes
JSON string with app-store-connect actions get-latest-build-number, get-latest-app-store-build-number and get-latest-testflight-build-number if --json option is specified.Docs
app-store-connect get-latest-build-number,app-store-connect get-latest-app-store-build-number,app-store-connect get-latest-testflight-build-number.Log out processed build and its beta detail information before submitting it to App Store or TestFlight. PR #347
Features
Additions and changes from pull request #345.
Additions and changes from pull request #345.
Features
google-play tracks promote-release to promote a release from one Google Play release track to another.Development
bounded_number for CLI usage that can be used to load floats and integers from CLI inputs within specified ranges.update_track to update release track in Google Play API client codemagic.google_play.api_client.GooglePlayDeveloperAPIClient.Documentation
google-play tracks.google-play tracks promote-release.Additions and changes from pull request #340. Resolves issue #339.
Additions and changes from pull request #340. Resolves issue #339.
Features
app-store-connect publish --testflight.app-store-connect builds beta-details to show beta detail information for specific build.Development
read_beta_detail to builds resource manager in src/codemagic/apple/app_store_connect/builds/builds.py.BuildBetaDetail for https://developer.apple.com/documentation/appstoreconnectapi/buildbetadetail,ExternalBetaState enumeration for https://developer.apple.com/documentation/appstoreconnectapi/externalbetastate,InternalBetaState for https://developer.apple.com/documentation/appstoreconnectapi/internalbetastate.Documentation
app-store-connect builds betat-details.Special thanks for contribution to @nilsreichardt.
Fix iOS application package abstraction layer in codemagic.models.application_package.Ipa to support large archives (exceeding 4GB in size). PR #342
Bugfixes
codemagic.models.application_package.Ipa to support large archives (exceeding 4GB in size). PR #342Do not require certificate private key to show certificate information using app-store-connect get-certificate if certificate is not saved to disk. PR
Bugfixes
app-store-connect get-certificate if certificate is not saved to disk. PR #337Add --omit-sdk option to action xcode-project run-tests to exclude -sdk flag from being passed to underlying xcodebuild test command. PR #335
Features
--omit-sdk option to action xcode-project run-tests to exclude -sdk flag from being passed to underlying xcodebuild test command. PR #335None of the breaking changes have an effect on command line usage, only the Python API of is affected.
Changes in this release improve app-store-connect register-device action by allowing to pass multiple UDIDs from different sources.
None of the breaking changes have an effect on command line usage, only the Python API of is affected.
Features
app-store-connect register-device action:
--udid argument now accepts multiple UDIDs.--udid argument now accepts a file or an environment variable as a source for UDIDs.--ignore-registration-errors flag to continue registering devices despite errors-n flag for the device name,-u flag for the UDIDs.Development
AppStoreConnect.register_device action method update:
device_udids.AppStoreConnect.register_device now returns a list of registered devices.ignore_registration_errors keyword argument to continue registering devices despite errors.Documentation
app-store-connect register-device action:
-n and -u.--ignore-registration-errors option.Format Python source code with Black. PR #322
Method list_capabilility_ids of codemagic.apple.app_store_connect.provisioning.BundleIds is deprecated and shows a deprecation warning on calls. Use l…
Deprecations
list_capabilility_ids of codemagic.apple.app_store_connect.provisioning.BundleIds is deprecated and shows a deprecation warning on calls. Use list_capability_ids of the same class instead. PR #326Development
deprecated decorator in codemagic.utilities.decorators to mark functions and methods as obsolete. PR #326Add support for visionOS runtime. PR #325
Features
Do not require releaseNotes from Firebase App Distribution release responses. PR #323
Bugfixes
releaseNotes from Firebase App Distribution release responses. PR #323Dependencies
>= 2.84.0 to google-api-python-client Python dependency in order to comply with Firebase App Distribution APIs. PR #322Add interface to declare aliases for deprecated actions. PR #187
Development
Introduce firebase-app-distribution tool with the actions:
Features
firebase-app-distribution tool with the actions:
firebase-app-distribution releases list action to list releasesfirebase-app-distribution get-latest-build-version to get a version number for the latest release buildDevelopment
FirebaseAppDistribution.list_releasesFirebaseAppDistribution.get_latest_build_versionTests
FirebaseClientFirebaseAppDistribution.list_releases and FirebaseAppDistribution.get_latest_build_versionDocumentation
firebase-app-distribution toolfirebase-app-distribution releases listfirebase-app-distribution get-latest-build-versionOne column per quarter.