Apple Container Operator

Apple Container Operator is a portable SKILL.md pack for AI coding agents working with Apple’s native container runtime. It translates natural-language requests and familiar Docker-style commands into conservative, capability-checked workflows.

What it helps with

• Install and inspect Apple container using the official Apple release packages.
• Plan and perform container lifecycle operations such as running, listing, inspecting logs, stopping, and restarting.
• Analyze local repositories and Docker/Compose configuration before planning a migration or container setup.
• Plan changes to ports, environment variables, mounts, images, and startup commands while preserving existing settings.
• Troubleshoot system, image, container, port, and mount issues with read-only diagnostics first.

What is included

• A root SKILL.md with agent instructions.
• 11 workflow and safety reference files.
• 6 shell/Python helpers for detection, inspection, installation, Docker-intent translation, repository analysis, and freshness checks.
• The Apache-2.0 license.

Requirements and limitations

Container execution requires a compatible Apple silicon Mac and a supported macOS version. Helper scripts require a shell and Python 3 where applicable. Installation and freshness checks use GitHub network access. The agent should verify local CLI help before using uncertain flags and obtain confirmation for destructive or stateful changes. Docker and Compose feature parity is not guaranteed. Copied-directory self-update may require a manual reinstall from upstream.

This is an independently developed, open-source skill pack, distributed under Apache-2.0. The upstream source is publicly available at https://github.com/lizhelang/apple-container-operator. Package source revision: 94aba6ecfa0a6e909a5969fa44def5ea664356e7.