Skip to content

virtualization: add macOS and Linux VM skill workflows#156

Merged
gaelic-ghost merged 4 commits into
mainfrom
apple/macos-virtualization-skills-plan
Jul 19, 2026
Merged

virtualization: add macOS and Linux VM skill workflows#156
gaelic-ghost merged 4 commits into
mainfrom
apple/macos-virtualization-skills-plan

Conversation

@gaelic-ghost

@gaelic-ghost gaelic-ghost commented Jul 19, 2026

Copy link
Copy Markdown
Owner

Summary

  • add four Apple Dev virtualization selection, framework, Linux guest, and macOS guest workflows
  • expand Apple container guidance for CLI 1.x and persistent container machines
  • add disposable security-lab preparation plus guest-versus-host evidence controls
  • export portable skills to Hermes and align Claude, Cowork, architecture, metadata, and docs
  • prepare the shared Socket 9.19.0 minor version after 9.18.0 was published concurrently

Review findings addressed

  • updated stale Apple inventory and customization counts
  • restored metadata phrases required by existing Apple workflow contracts
  • made headless VM ownership, virtualization artifacts, and Gatekeeper/TCC routing explicit
  • shortened all new Hermes descriptions below the warning threshold
  • rebased onto v9.18.0 while preserving the concurrent Model Lab inventory as Milestone 29 and renumbering virtualization to Milestone 30

Verification

  • Apple Dev docs validator
  • 268 Apple Dev tests
  • Cybersecurity metadata validator for 31 skills
  • 126 Socket tests passed; 1 intentional skip
  • Socket marketplace, Hermes, Claude/Cowork, and architecture validation
  • 10 virtualization forward-scenario contracts

@gaelic-ghost gaelic-ghost added the enhancement New feature or request label Jul 19, 2026
@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown

Important

Review skipped

Too many files!

This PR contains 142 files, which is 42 over the limit of 100.

To get a review, narrow the scope:
• coderabbit review --type committed # exclude uncommitted changes
• coderabbit review --dir # limit to a subdirectory
• coderabbit review --base # compare against a closer base

Upgrade to a paid plan to raise the limit.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 221483f5-f04e-4383-950f-2aad365b91c8

📥 Commits

Reviewing files that changed from the base of the PR and between cc4355f and e023322.

⛔ Files ignored due to path filters (8)
  • plugins/agent-portability-skills/uv.lock is excluded by !**/*.lock
  • plugins/apple-dev-skills/uv.lock is excluded by !**/*.lock
  • plugins/cardhop-app/mcp/uv.lock is excluded by !**/*.lock
  • plugins/productivity-skills/uv.lock is excluded by !**/*.lock
  • plugins/python-skills/uv.lock is excluded by !**/*.lock
  • plugins/things-app/mcp/uv.lock is excluded by !**/*.lock
  • plugins/things-app/uv.lock is excluded by !**/*.lock
  • uv.lock is excluded by !**/*.lock
📒 Files selected for processing (142)
  • .claude-plugin/marketplace.json
  • README.md
  • ROADMAP.md
  • docs/architecture/ARCHITECTURE.md
  • docs/architecture/architecture.json
  • docs/maintainers/claude-compatibility.json
  • docs/maintainers/macos-virtualization-and-container-skills-plan.md
  • plugins/agent-portability-skills/.codex-plugin/plugin.json
  • plugins/agent-portability-skills/pyproject.toml
  • plugins/agentdeck/.codex-plugin/plugin.json
  • plugins/android-dev-skills/.codex-plugin/plugin.json
  • plugins/apple-creator-studio-skills/.codex-plugin/plugin.json
  • plugins/apple-dev-skills/.codex-plugin/plugin.json
  • plugins/apple-dev-skills/.github/scripts/validate_repo_docs.sh
  • plugins/apple-dev-skills/README.md
  • plugins/apple-dev-skills/ROADMAP.md
  • plugins/apple-dev-skills/docs/maintainers/customization-consolidation-review.md
  • plugins/apple-dev-skills/pyproject.toml
  • plugins/apple-dev-skills/skills/choose-macos-virtualization-shape/SKILL.md
  • plugins/apple-dev-skills/skills/choose-macos-virtualization-shape/agents/openai.yaml
  • plugins/apple-dev-skills/skills/choose-macos-virtualization-shape/references/customization-flow.md
  • plugins/apple-dev-skills/skills/choose-macos-virtualization-shape/references/customization.template.yaml
  • plugins/apple-dev-skills/skills/choose-macos-virtualization-shape/references/snippets/apple-xcode-project-core.md
  • plugins/apple-dev-skills/skills/choose-macos-virtualization-shape/references/virtualization-shape-record.md
  • plugins/apple-dev-skills/skills/choose-macos-virtualization-shape/scripts/customization_config.py
  • plugins/apple-dev-skills/skills/linux-development-vm-workflow/SKILL.md
  • plugins/apple-dev-skills/skills/linux-development-vm-workflow/agents/openai.yaml
  • plugins/apple-dev-skills/skills/linux-development-vm-workflow/references/customization-flow.md
  • plugins/apple-dev-skills/skills/linux-development-vm-workflow/references/customization.template.yaml
  • plugins/apple-dev-skills/skills/linux-development-vm-workflow/references/linux-development-guest-matrix.md
  • plugins/apple-dev-skills/skills/linux-development-vm-workflow/references/snippets/apple-xcode-project-core.md
  • plugins/apple-dev-skills/skills/linux-development-vm-workflow/scripts/customization_config.py
  • plugins/apple-dev-skills/skills/macos-development-vm-workflow/SKILL.md
  • plugins/apple-dev-skills/skills/macos-development-vm-workflow/agents/openai.yaml
  • plugins/apple-dev-skills/skills/macos-development-vm-workflow/references/customization-flow.md
  • plugins/apple-dev-skills/skills/macos-development-vm-workflow/references/customization.template.yaml
  • plugins/apple-dev-skills/skills/macos-development-vm-workflow/references/macos-vm-artifact-lifecycle.md
  • plugins/apple-dev-skills/skills/macos-development-vm-workflow/references/snippets/apple-xcode-project-core.md
  • plugins/apple-dev-skills/skills/macos-development-vm-workflow/scripts/customization_config.py
  • plugins/apple-dev-skills/skills/virtualization-framework-workflow/SKILL.md
  • plugins/apple-dev-skills/skills/virtualization-framework-workflow/agents/openai.yaml
  • plugins/apple-dev-skills/skills/virtualization-framework-workflow/references/customization-flow.md
  • plugins/apple-dev-skills/skills/virtualization-framework-workflow/references/customization.template.yaml
  • plugins/apple-dev-skills/skills/virtualization-framework-workflow/references/macos-and-linux-guest-matrix.md
  • plugins/apple-dev-skills/skills/virtualization-framework-workflow/references/snippets/apple-xcode-project-core.md
  • plugins/apple-dev-skills/skills/virtualization-framework-workflow/references/virtualization-device-and-availability-matrix.md
  • plugins/apple-dev-skills/skills/virtualization-framework-workflow/scripts/customization_config.py
  • plugins/apple-dev-skills/tests/test_app_extension_workflows.py
  • plugins/apple-dev-skills/tests/test_apple_developer_provisioning_workflow.py
  • plugins/apple-dev-skills/tests/test_arkit_spatial_face_body_workflows.py
  • plugins/apple-dev-skills/tests/test_camera_capture_depth_workflow.py
  • plugins/apple-dev-skills/tests/test_customization_consolidation_review.py
  • plugins/apple-dev-skills/tests/test_devicecheck_app_attest_workflow.py
  • plugins/apple-dev-skills/tests/test_imaging_foundation_workflows.py
  • plugins/apple-dev-skills/tests/test_macos_virtualization_workflows.py
  • plugins/apple-dev-skills/tests/test_photos_library_editing_workflow.py
  • plugins/apple-dev-skills/tests/test_tipkit_workflow.py
  • plugins/apple-dev-skills/tests/test_video_codec_processing_workflow.py
  • plugins/apple-dev-skills/tests/test_vision_recognition_workflows.py
  • plugins/apple-dev-skills/tests/test_xcode_localization_workflow.py
  • plugins/cardhop-app/.codex-plugin/plugin.json
  • plugins/cardhop-app/mcp/pyproject.toml
  • plugins/cloud-deployment-skills/.codex-plugin/plugin.json
  • plugins/cloud-inference-skills/.codex-plugin/plugin.json
  • plugins/cybersecurity-skills/.codex-plugin/plugin.json
  • plugins/cybersecurity-skills/scripts/validate_repo_metadata.py
  • plugins/cybersecurity-skills/skills/assess-macos-threat/SKILL.md
  • plugins/cybersecurity-skills/skills/inspect-macos-persistence/SKILL.md
  • plugins/cybersecurity-skills/skills/inspect-macos-runtime-activity/SKILL.md
  • plugins/cybersecurity-skills/skills/perform-dynamic-malware-analysis/SKILL.md
  • plugins/cybersecurity-skills/skills/prepare-isolated-analysis-lab/SKILL.md
  • plugins/cybersecurity-skills/skills/prepare-isolated-analysis-lab/agents/openai.yaml
  • plugins/cybersecurity-skills/skills/prepare-isolated-analysis-lab/references/security-lab-control-profile.md
  • plugins/cybersecurity-skills/skills/select-analysis-isolation/SKILL.md
  • plugins/dotnet-skills/.codex-plugin/plugin.json
  • plugins/game-dev-skills/.codex-plugin/plugin.json
  • plugins/messaging-collaboration-skills/.codex-plugin/plugin.json
  • plugins/model-lab-skills/.codex-plugin/plugin.json
  • plugins/network-protocol-skills/.codex-plugin/plugin.json
  • plugins/productivity-skills/.codex-plugin/plugin.json
  • plugins/productivity-skills/pyproject.toml
  • plugins/python-skills/.codex-plugin/plugin.json
  • plugins/python-skills/pyproject.toml
  • plugins/reverse-engineering-skills/.codex-plugin/plugin.json
  • plugins/rust-skills/.codex-plugin/plugin.json
  • plugins/server-side-jvm/.codex-plugin/plugin.json
  • plugins/server-side-swift/.codex-plugin/plugin.json
  • plugins/server-side-swift/skills/apple-containerization-workflow/SKILL.md
  • plugins/server-side-swift/skills/apple-containerization-workflow/references/apple-container-version-matrix.md
  • plugins/spotify/.codex-plugin/plugin.json
  • plugins/swift-lang/.codex-plugin/plugin.json
  • plugins/swiftasb-skills/.codex-plugin/plugin.json
  • plugins/things-app/.codex-plugin/plugin.json
  • plugins/things-app/mcp/pyproject.toml
  • plugins/things-app/pyproject.toml
  • plugins/web-dev-skills/.codex-plugin/plugin.json
  • pyproject.toml
  • scripts/export_hermes_skills.py
  • skills.sh.json
  • skills/apple-containerization-workflow/SKILL.md
  • skills/apple-containerization-workflow/references/apple-container-version-matrix.md
  • skills/assess-macos-threat/SKILL.md
  • skills/choose-macos-virtualization-shape/SKILL.md
  • skills/choose-macos-virtualization-shape/agents/openai.yaml
  • skills/choose-macos-virtualization-shape/references/customization-flow.md
  • skills/choose-macos-virtualization-shape/references/customization.template.yaml
  • skills/choose-macos-virtualization-shape/references/snippets/apple-xcode-project-core.md
  • skills/choose-macos-virtualization-shape/references/virtualization-shape-record.md
  • skills/choose-macos-virtualization-shape/scripts/customization_config.py
  • skills/inspect-macos-persistence/SKILL.md
  • skills/inspect-macos-runtime-activity/SKILL.md
  • skills/linux-development-vm-workflow/SKILL.md
  • skills/linux-development-vm-workflow/agents/openai.yaml
  • skills/linux-development-vm-workflow/references/customization-flow.md
  • skills/linux-development-vm-workflow/references/customization.template.yaml
  • skills/linux-development-vm-workflow/references/linux-development-guest-matrix.md
  • skills/linux-development-vm-workflow/references/snippets/apple-xcode-project-core.md
  • skills/linux-development-vm-workflow/scripts/customization_config.py
  • skills/macos-development-vm-workflow/SKILL.md
  • skills/macos-development-vm-workflow/agents/openai.yaml
  • skills/macos-development-vm-workflow/references/customization-flow.md
  • skills/macos-development-vm-workflow/references/customization.template.yaml
  • skills/macos-development-vm-workflow/references/macos-vm-artifact-lifecycle.md
  • skills/macos-development-vm-workflow/references/snippets/apple-xcode-project-core.md
  • skills/macos-development-vm-workflow/scripts/customization_config.py
  • skills/perform-dynamic-malware-analysis/SKILL.md
  • skills/prepare-isolated-analysis-lab/SKILL.md
  • skills/prepare-isolated-analysis-lab/agents/openai.yaml
  • skills/prepare-isolated-analysis-lab/references/security-lab-control-profile.md
  • skills/select-analysis-isolation/SKILL.md
  • skills/virtualization-framework-workflow/SKILL.md
  • skills/virtualization-framework-workflow/agents/openai.yaml
  • skills/virtualization-framework-workflow/references/customization-flow.md
  • skills/virtualization-framework-workflow/references/customization.template.yaml
  • skills/virtualization-framework-workflow/references/macos-and-linux-guest-matrix.md
  • skills/virtualization-framework-workflow/references/snippets/apple-xcode-project-core.md
  • skills/virtualization-framework-workflow/references/virtualization-device-and-availability-matrix.md
  • skills/virtualization-framework-workflow/scripts/customization_config.py
  • tests/test_cybersecurity_skill_contracts.py
  • tests/test_macos_virtualization_forward_scenarios.py
  • tests/test_macos_virtualization_skill_contracts.py
  • tests/test_validate_hermes_compatibility.py

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Review on demand using usage pricing
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch apple/macos-virtualization-skills-plan

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Why:
Ship the reviewed virtualization and container skill expansion after Socket 9.18.0 was published concurrently.

Verification:
- 268 Apple Dev tests
- 126 Socket tests passed; 1 intentional skip
- Apple Dev and Cybersecurity validators
- Socket marketplace, Hermes, Claude/Cowork, and architecture validation
@gaelic-ghost
gaelic-ghost force-pushed the apple/macos-virtualization-skills-plan branch from 78da183 to e023322 Compare July 19, 2026 17:44
@gaelic-ghost
gaelic-ghost merged commit 6dee4b4 into main Jul 19, 2026
2 checks passed
@gaelic-ghost
gaelic-ghost deleted the apple/macos-virtualization-skills-plan branch July 19, 2026 17:45

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 78da183933

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".


1. Verify CLI version 1.x, current machine documentation, and installed `container machine --help` output.
2. Record the OCI image/digest, architecture, init system, default-machine state, CPU, memory, disks, home-mount policy, kernel, and required services.
3. Inspect the exact create, run, list/inspect, set-default, resource-change, stop, and remove subcommand help before recommending syntax.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use the actual delete/rm machine command

For users following this new container-machine workflow through teardown, this points them at a remove subcommand, but the current apple/container command reference lists the machine deletion command as container machine delete (rm); there is no container machine remove. That makes the prescribed help check/cleanup command fail and can leave the persistent machine storage around, so this should name delete/rm instead.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant