codemagic-agent-tools 1.2.0__tar.gz

codemagic_agent_tools-1.2.0/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "codemagic-tools",
+  "interface": {
+    "displayName": "Codemagic community tools"
+  },
+  "plugins": [
+    {
+      "name": "codemagic",
+      "source": {
+        "source": "local",
+        "path": "./"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_USE"
+      },
+      "category": "Developer Tools"
+    }
+  ]
+}

codemagic_agent_tools-1.2.0/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "codemagic-tools",
+  "owner": {
+    "name": "Helge Sverre"
+  },
+  "plugins": [
+    {
+      "name": "codemagic",
+      "source": "./",
+      "description": "Unofficial Codemagic build operations and iOS/Android signing guidance for coding agents.",
+      "version": "1.2.0"
+    }
+  ],
+  "description": "Unofficial Codemagic CI/CD tools for AI coding agents."
+}

codemagic_agent_tools-1.2.0/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "codemagic",
+  "version": "1.2.0",
+  "description": "Unofficial Codemagic build operations and iOS/Android signing guidance for coding agents.",
+  "author": {
+    "name": "Helge Sverre",
+    "url": "https://github.com/HelgeSverre"
+  },
+  "homepage": "https://github.com/HelgeSverre/codemagic-skill",
+  "repository": "https://github.com/HelgeSverre/codemagic-skill",
+  "license": "MIT",
+  "keywords": [
+    "codemagic",
+    "ci-cd",
+    "claude-code",
+    "codex",
+    "agent-skills"
+  ]
+}

codemagic_agent_tools-1.2.0/.python-version

@@ -0,0 +1 @@
+3.11

codemagic_agent_tools-1.2.0/CONTRIBUTING.md

@@ -0,0 +1,70 @@
+# Contributing
+
+The Git repository is the canonical source. Keep the API implementation at
+`skills/codemagic/scripts/codemagic_api.py`; the Python package entry point and
+both agent plugins use this same file. The optional MCP adapter lives beside it
+in `codemagic_mcp.py` and shares authentication, HTTP handling, and build
+validation. The skill must remain usable when its folder is copied on its own,
+without the rest of the repository.
+
+## Local setup
+
+```sh
+uv sync --locked --extra mcp
+uv run --extra mcp ruff check .
+uv run --extra mcp ruff format .
+uv run --extra mcp python -m unittest discover -s tests -v
+uv run --extra mcp python scripts/validate_package.py
+```
+
+To develop the command globally from this checkout:
+
+```sh
+uv tool install --editable '.[mcp]'
+```
+
+For a standalone skill installation, link `skills/codemagic` into
+`~/.agents/skills/codemagic` for Codex or `~/.claude/skills/codemagic` for Claude.
+Do not replace an existing installation without preserving its local notes.
+Plugin developers can use `claude --plugin-dir .` or add this checkout as a local
+Codex marketplace.
+
+Keep credentials and account-specific IDs out of the public skill. Local context
+can live under `~/.config/codemagic-api/context.md`, which agents read only when
+relevant to the requested account.
+
+## Tests and releases
+
+Tests mock HTTP responses and cover request contracts, credential precedence,
+redaction, cancellation, pagination, and uncertain request outcomes. MCP tests also
+exercise schemas, tool annotations, and stdio with current and legacy handshakes.
+Package validation checks the portable manifest against the vendored Agent Plugins
+schema and verifies that the two marketplace catalogs resolve to the same plugin.
+Archive tests extract the plugin and run the bundled CLI from another directory.
+
+The vendored `schemas/plugin.schema.json` is the published
+[Agent Plugins 1.0 schema](https://agent-plugins.org/schemas/1.0.0/plugin.schema.json).
+Refresh it deliberately when changing the manifest format, and rerun validation.
+
+Run the real-client checks in [docs/compatibility.md](docs/compatibility.md) after
+changing skill discovery, manifests, or bundled paths. Use synthetic IDs and
+`--dry-run`; a live start/cancel is not needed to verify packaging.
+
+Keep versions aligned in `pyproject.toml`, `plugin.json`,
+`.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, and the CLI's
+`VERSION` constant. Run `uv lock` after changing project metadata or dependencies.
+
+```sh
+uv build
+uv run --extra mcp python scripts/build_plugin.py
+```
+
+Publish a GitHub release from `main` with a tag matching the package version
+(for example, `v1.2.0`). `.github/workflows/publish.yml` validates and builds
+Python distributions, then uploads them to PyPI using Trusted Publishing.
+Set up the pending publisher once using the exact fields in
+[Publishing](docs/publishing.md). No PyPI API token or repository secret is needed.
+PRs and manual workflow runs build and validate without publishing.
+
+Attach the plugin ZIP from the successful CI run to the GitHub release. The ZIP
+is not uploaded to PyPI. Official plugin-directory submission remains separate.

codemagic_agent_tools-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Helge Sverre
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codemagic_agent_tools-1.2.0/MANIFEST.in

@@ -0,0 +1,8 @@
+include LICENSE README.md CONTRIBUTING.md plugin.json uv.lock .python-version
+recursive-include skills *.md *.py *.yaml
+recursive-include .claude-plugin *.json
+recursive-include .agents/plugins *.json
+recursive-include docs *.md *.png
+recursive-include tests *.py
+recursive-include scripts *.py
+recursive-include schemas *.json

codemagic_agent_tools-1.2.0/PKG-INFO

@@ -0,0 +1,287 @@
+Metadata-Version: 2.4
+Name: codemagic-agent-tools
+Version: 1.2.0
+Summary: Unofficial Codemagic CLI, MCP server, and mobile signing skills for coding agents
+Author: Helge Sverre
+License-Expression: MIT
+Project-URL: Repository, https://github.com/HelgeSverre/codemagic-skill
+Project-URL: Issues, https://github.com/HelgeSverre/codemagic-skill/issues
+Keywords: codemagic,codex,claude-code,ci-cd,agent-skills
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2.2; extra == "mcp"
+Dynamic: license-file
+
+![Codemagic Skill — builds, workflows and artifacts for AI agents](https://raw.githubusercontent.com/HelgeSverre/codemagic-skill/main/docs/assets/header.png)
+
+# Codemagic Skill
+
+[![CI](https://github.com/HelgeSverre/codemagic-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/HelgeSverre/codemagic-skill/actions/workflows/ci.yml)
+[![Python 3.11+](https://img.shields.io/badge/Python-3.11%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/)
+[![uv](https://img.shields.io/badge/managed_with-uv-DE5FE9)](https://docs.astral.sh/uv/)
+[![Ruff](https://img.shields.io/badge/lint%20%26%20format-Ruff-D7FF64)](https://docs.astral.sh/ruff/)
+[![Claude Code + Codex](https://img.shields.io/badge/agents-Claude_Code_%2B_Codex-F97316)](#install-the-plugin)
+[![MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/HelgeSverre/codemagic-skill/blob/main/LICENSE)
+
+Give your coding agent the tools to operate your Codemagic builds. Find an
+app, select a workflow, start a build from a branch or tag, inspect the result,
+and locate its artifacts—all through the official Codemagic REST API.
+
+The API skill's bundled Python CLI has **zero runtime dependencies** and also
+runs on its own. An optional [MCP server](#mcp-tools) exposes the same API as
+typed agent tools. No hosted service or PyPI publication is required.
+
+The package contains two portable skills:
+
+- **`codemagic`** operates apps, workflows, builds and artifacts.
+- **`codemagic-signing`** diagnoses iOS/Android signing and helps configure an
+  existing project while preserving its signing identity. It distinguishes
+  provisioning, Gradle wiring, store permissions and runtime certificate issues.
+
+The signing skill complements the official
+[codemagic-init](https://docs.codemagic.io/troubleshooting/codemagic-init/) setup
+tool. It does not provision account credentials or start builds merely by loading.
+
+> “Show the latest failed build for my app and which steps failed.”
+>
+> “Build the staging workflow from `feature/login`.”
+>
+> “Find the APK and IPA artifacts from that build.”
+
+## Install the plugin
+
+API commands require Python 3.11+ and normal shell access. Use a current client
+with the skill or plugin support described below. The package includes the CLI;
+agents can run the bundled script directly.
+
+### Claude Code
+
+```sh
+claude plugin marketplace add HelgeSverre/codemagic-skill
+claude plugin install codemagic@codemagic-tools
+```
+
+Start a new session and use `/codemagic:codemagic`, or ask a Codemagic question.
+For a local checkout, try `claude --plugin-dir /path/to/codemagic-skill`.
+
+### Codex
+
+```sh
+codex plugin marketplace add HelgeSverre/codemagic-skill
+codex plugin add codemagic@codemagic-tools
+```
+
+Start a new session and select the `codemagic` skill from the plugin. You can
+also ask directly: “Use the Codemagic skill to list my apps.”
+
+### GitHub Copilot CLI
+
+```sh
+copilot plugin install HelgeSverre/codemagic-skill
+```
+
+The existing Agent Plugins manifest and `skills/` directory work directly.
+
+### Gemini CLI
+
+```sh
+gemini skills install https://github.com/HelgeSverre/codemagic-skill.git --path skills
+```
+
+Gemini installs the skills directly; it does not need an extension wrapper.
+Workspace installations also require a trusted workspace. Skill activation and
+shell execution remain subject to Gemini's normal consent and permissions.
+
+### Other agent harnesses
+
+OpenCode, Cursor, Amp, Pi, Goose and current Windsurf/Devin support the portable
+skill folder. See the [support matrix and installation recipes](https://github.com/HelgeSverre/codemagic-skill/blob/main/docs/agent-support.md)
+for tested discovery results, supported paths and limitations. Cline uses its
+own documented skill directory.
+
+The Vercel Skills CLI also discovers this repository. List available skills first,
+then choose a target rather than installing into every detected agent:
+
+```sh
+npx skills add HelgeSverre/codemagic-skill --list
+npx skills add HelgeSverre/codemagic-skill --skill codemagic --agent amp --global
+```
+
+For signing guidance, select `--skill codemagic-signing`.
+
+### Install only the skills
+
+Copy a self-contained folder under `skills/` into your client's user skill
+directory. This works without plugin support:
+
+```sh
+git clone https://github.com/HelgeSverre/codemagic-skill.git
+mkdir -p ~/.agents/skills ~/.claude/skills
+cp -R codemagic-skill/skills/codemagic ~/.agents/skills/codemagic
+cp -R codemagic-skill/skills/codemagic ~/.claude/skills/codemagic
+# Optional companion skill, installed independently in the same way:
+cp -R codemagic-skill/skills/codemagic-signing ~/.agents/skills/codemagic-signing
+```
+
+Use either the plugin or the standalone skill in each client to avoid duplicate
+entries. Codex also supports `~/.codex/skills` in installations that use that
+location. For development, symlink the skill directory to keep the checkout
+canonical; see [Contributing](https://github.com/HelgeSverre/codemagic-skill/blob/main/CONTRIBUTING.md).
+
+## MCP tools
+
+Use the optional MCP server when you want your agent to call tools directly.
+Install it once with [uv](https://docs.astral.sh/uv/):
+
+```sh
+uv tool install 'codemagic-agent-tools[mcp] @ git+https://github.com/HelgeSverre/codemagic-skill.git'
+claude mcp add --scope user --transport stdio codemagic -- codemagic-mcp
+codex mcp add codemagic -- codemagic-mcp
+```
+
+Configure only the clients you use. The agent starts `codemagic-mcp` on demand
+as a local stdio process. It uses the same `CODEMAGIC_API_KEY` or saved login as
+the CLI. For Codex, add `env_vars = ["CODEMAGIC_API_KEY"]` under
+`[mcp_servers.codemagic]` when using environment authentication.
+
+Tools cover authentication status, teams, apps, workflows, builds, steps,
+artifacts, build previews, build starts and cancellation. Previews require no
+credentials and send no requests. Installing the skill/plugin alone keeps the
+MCP server optional; adding it does not duplicate the skills.
+
+See [MCP setup](https://github.com/HelgeSverre/codemagic-skill/blob/main/docs/mcp.md) for JSON configuration, local development, credentials,
+the tool list, and verification. The MCP extra requires the official Python MCP
+SDK; the CLI still needs only Python 3.11+.
+
+## Authentication
+
+Create a personal API token in Codemagic under **Teams → Personal Account →
+Integrations → Codemagic API → Show**. Some UI versions call this **Account
+settings → API token**. The token has your account's team permissions.
+
+Expose it as `CODEMAGIC_API_KEY` in the environment that launches your agent or
+terminal. `CODEMAGIC_API_TOKEN` and `CM_API_TOKEN` are also supported, in that
+order after `CODEMAGIC_API_KEY`.
+
+For a local terminal login, install the CLI below and run:
+
+```sh
+codemagic-api auth login
+codemagic-api auth status
+```
+
+The hidden prompt verifies the token before saving it. On macOS/Linux, the
+fallback token file is `~/.config/codemagic-api/token` (or under
+`$XDG_CONFIG_HOME`), with permissions `0600`. It is plaintext. Windows uses an
+environment variable instead of token-file login. No token belongs in this repo,
+plugin manifests, prompts, or shell command arguments.
+
+## Standalone CLI
+
+Install from Git with [uv](https://docs.astral.sh/uv/):
+
+```sh
+uv tool install git+https://github.com/HelgeSverre/codemagic-skill.git
+codemagic-api --help
+```
+
+Or run from a checkout without installing anything:
+
+```sh
+python3 skills/codemagic/scripts/codemagic_api.py --help
+```
+
+| Task | Command |
+| --- | --- |
+| List teams | `codemagic-api teams` |
+| Find team apps | `codemagic-api apps --team TEAM_ID --name my-app` |
+| List workflows | `codemagic-api workflows APP_ID` |
+| Recent builds | `codemagic-api builds --team TEAM_ID --app APP_ID` |
+| Build details | `codemagic-api build BUILD_ID` |
+| Step statuses | `codemagic-api actions BUILD_ID` |
+| Artifact URLs | `codemagic-api artifacts BUILD_ID` |
+| Cancel a build | `codemagic-api cancel BUILD_ID` |
+
+Start a build with the **workflow ID**, which may differ from its display name:
+
+```sh
+codemagic-api start --app APP_ID --workflow WORKFLOW_ID \
+  --branch feature/login --dry-run
+
+# Submit the same request after reviewing the preview.
+codemagic-api start --app APP_ID --workflow WORKFLOW_ID \
+  --branch feature/login
+```
+
+Use exactly one of `--branch` or `--tag`. `--inputs-file` and
+`--environment-file` accept JSON objects for workflow inputs and environment
+overrides. List commands return pagination metadata; use `--page` or `--cursor`
+to fetch subsequent results. Output is JSON, with diagnostics on stderr.
+
+For other documented JSON endpoints:
+
+```sh
+codemagic-api api GET '/teams/TEAM_ID/variable-groups'
+codemagic-api api POST '/apps/APP_ID/builds' --data-file request.json --dry-run
+```
+
+Read the [API notes](https://github.com/HelgeSverre/codemagic-skill/blob/main/skills/codemagic/references/api.md) for payload formats,
+version differences, and endpoint mappings.
+
+## Behavior to know
+
+- A selected workflow can publish to stores or testers. Starting that workflow
+  runs its configured publishing steps too.
+- A build request accepted with HTTP 202 is queued, not completed. Its ID may
+  briefly return 404 while Codemagic creates the build.
+- Requests are never retried automatically. After an uncertain build-start
+  outcome, check recent builds before submitting again.
+- API calls use v3, except cancellation, which still uses Codemagic's documented
+  legacy endpoint.
+- `actions` returns step statuses and scripts, not full raw logs. `artifacts`
+  lists artifact metadata and URLs; it does not download files or create public links.
+- Token values, sensitive field names, and environment/input values are redacted
+  from responses. Build scripts and artifact URLs can still contain private data.
+
+## Development and verification
+
+```sh
+uv sync --locked --extra mcp
+uv run --extra mcp ruff check .
+uv run --extra mcp ruff format --check .
+uv run --extra mcp python -m unittest discover -s tests -v
+uv run --extra mcp python scripts/validate_package.py
+uv build
+uv run --extra mcp python scripts/build_plugin.py
+```
+
+CI runs lint, formatting, package validation, and offline tests on macOS, Linux,
+and Windows, including MCP discovery and calls over stdio. It also builds the Python wheel/sdist and distributable plugin ZIP.
+It does not need a Codemagic token and never starts a real build.
+
+The [PyPI publishing workflow](https://github.com/HelgeSverre/codemagic-skill/blob/main/docs/publishing.md)
+validates Python distributions on PRs and publishes on GitHub releases using
+Trusted Publishing. Git installation works independently of PyPI. For releases
+available on PyPI, use
+`uv tool install 'codemagic-agent-tools[mcp]'` for the CLI and MCP server, or
+`uv tool install codemagic-agent-tools` for the CLI alone.
+
+See [compatibility verification](https://github.com/HelgeSverre/codemagic-skill/blob/main/docs/compatibility.md) for the tested clients,
+test boundaries, and steps to repeat the agent checks. See
+[Contributing](https://github.com/HelgeSverre/codemagic-skill/blob/main/CONTRIBUTING.md) for the canonical source layout.
+
+## License and credits
+
+Code and documentation are [MIT licensed](https://github.com/HelgeSverre/codemagic-skill/blob/main/LICENSE). The header illustration was
+AI-generated for this project using Codemagic's visual identity as inspiration.
+Codemagic names, logos, and other trademarks remain the property of their
+respective owners; the software license grants no trademark rights.
+
+**Disclaimer:** This is an unofficial community project. It is not affiliated
+with, endorsed by, or sponsored by Codemagic or Nevercode Ltd. Claude and Codex
+are trademarks of their respective owners; this project is not endorsed by
+Anthropic or OpenAI.