Metadata-Version: 2.5
Name: codemagic-init
Version: 1.0.3
Summary: Set up Codemagic CI/CD for your project — generate a codemagic.yaml and equip your AI agent to debug builds and answer Codemagic questions.
Project-URL: Documentation, https://github.com/codemagic-ci-cd/codemagic-init
Requires-Python: >=3.10
Requires-Dist: pyyaml>=6.0
Description-Content-Type: text/markdown

# codemagic-init

`codemagic-init` does two things:

1. **Generate a `codemagic.yaml`** — inspects your project (`pubspec.yaml`, `build.gradle`, `Podfile`, …), asks a few questions about platforms, signing, distribution, and notifications, and writes a ready-to-commit `codemagic.yaml` along with a checklist of what still needs to be configured in Codemagic.

2. **Give your coding agent Codemagic knowledge** — if a coding agent is detected (Claude Code, Cursor, Windsurf, GitHub Copilot, …), `init` installs Codemagic skills into its context: the full docs and knowledge base so it can answer Codemagic-specific questions, help debug build failures, and suggest fixes. Skills are kept fresh by a cron job that refreshes them every 6 hours.

## Install

```bash
pip install codemagic-init
```

That puts `codemagic` on your PATH so you can run it from any project.

## Usage

```bash
codemagic            # show help
codemagic init       # scan → ask → write ./codemagic.yaml + install agent skills
codemagic update     # refresh skills and knowledge base manually
codemagic uninstall  # remove Codemagic skills from all agent config files
```

Run `codemagic init` from anywhere to install agent skills. To also generate a `codemagic.yaml`, run it from your project root — detected values (project type, platforms, application ids) are shown as defaults, press Enter to accept or type to override.

If a `codemagic.yaml` already exists, `init` asks before overwriting and saves the previous file to `codemagic.yaml.bak`.

## Feedback

Share feedback or report issues at https://github.com/codemagic-ci-cd/codemagic-init/discussions
