---
id: codemagic-cli-tools
version: "0.69.0"
license: GPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# codemagic-cli-tools — CLI tools used in Codemagic builds

License: copyleft · Maintenance: active · Downloads: 1.8M/mo

## What it is and what it does

Codemagic CLI Tools is a suite of command-line utilities and Python API for automating mobile app build, code signing, and deployment workflows. It powers builds at codemagic.io but can run in any environment with Python 3.8+. The package installs nine executables (android-app-bundle, android-keystore, app-store-connect, google-play, keychain, xcode-project, and others) that handle Android and iOS-specific tasks, plus a mirroring Python API in the codemagic.tools module for programmatic access.

The tools integrate with Apple App Store Connect and Google Play Developer APIs via oauth2client and google-api-python-client, manage cryptographic operations through cryptography and pyjwt, and provide system-level utilities via psutil and requests. Each CLI tool accepts structured arguments with support for environment variable and file-based secret injection, making it suitable for CI/CD pipelines and local development workflows.

Use it for:

- Automate Android app signing and bundle generation in CI/CD pipelines using android-keystore and android-app-bundle
- Deploy iOS apps to App Store Connect via the app-store-connect tool with API key authentication
- Publish Android apps to Google Play using the google-play tool with service account credentials
- Manage macOS keychains and Xcode project configurations locally or in build environments
- Generate git changelogs for release notes using the git-changelog tool during deployment workflows
- Programmatically orchestrate multi-step mobile builds by importing tools from codemagic.tools in Python scripts

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides command-line and Python API tools for managing Android and iOS app builds, code signing, and deployment workflows.

Yes, with conditions. Install if you need to automate iOS or Android app deployment in CI/CD or local environments and can accept the GPL-3.0-or-later copyleft license. The package is actively maintained, has low install friction, and integrates directly with App Store Connect and Google Play APIs. Verify that all nine runtime dependencies fit your environment and that you understand the copyleft implications for your use case.

## Install

pip install codemagic-cli-tools
uv add codemagic-cli-tools
poetry add codemagic-cli-tools

## Installing codemagic-cli-tools

Before you install: Low friction installation via pip. Actively maintained with recent releases; last commit 2026-07-15. Requires Python 3.8+. Depends on 9 runtime packages including cryptography, oauth2client, and google-api-python-client.

License in practice: Licensed under GPL-3.0-or-later (copyleft). Any derivative work or bundled distribution must also be licensed under GPL-3.0 or later and have source code available.

Quickstart:

pip install codemagic-cli-tools

from codemagic.tools import Keychain
from pathlib import Path

keychain = Keychain(Path("/tmp/new.keychain"))
keychain.create()
keychain.make_default()

Requires Python 3.8+. Some tools (e.g., keychain) are macOS-specific. API credentials required for App Store Connect or Google Play integration.

Verify before relying:

- Whether all nine runtime dependencies are required for all CLI tools or only for specific integrations
- Compatibility of keychain and xcode-project tools outside macOS environments
- Performance characteristics when managing large app bundles or multiple deployments

## Package facts

- License: GPL-3.0-or-later (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mobile app build automation, ios android deployment tools, code signing management cli, app store connect integration, google play deployment, keychain management, app build orchestration, mobile-ci-cd, app-deployment, code-signing

[View on SkillFed](https://skillfed.io/packages/codemagic-cli-tools) · [View on PyPI](https://pypi.org/project/codemagic-cli-tools/)