Skip to main content
skill CX Codex

macbox — Claude Code skill: what it does, how to install

macbox is a Claude Code skill that runs a macOS virtual machine inside Docker on Linux with host GPU acceleration. Automates iOS app builds and simulator testing without physical Apple hardware.

no license ★ 149 updated 2026-11-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add 0xdaniell/macbox --skill macbox -a claude-code
Open on GitHub

What macbox does

macbox sets up a Docker container running macOS via KVM and Reims vGPU for graphics pass-through. Inside the guest system, it provisions Xcode, an iOS Simulator pool, and T3 Code Device panel hooks.

Initial image compilation takes 20 to 60 minutes with macbox build. Operating Xcode requires an official .xip archive downloaded directly from developer.apple.com with an Apple Account.

The graphical interface opens in a browser via Selkies at http://127.0.0.1:6081/, while terminal control works through standard SSH connections.

What it helps with

  • run iOS simulators inside Docker on Linux systems
  • configure a macOS virtual machine with host GPU acceleration
  • inspect KVM, Docker, and kernel memory readiness using diagnostic commands
  • manage Xcode provisioning and virtual device pools via SSH

Example prompts for the agent

  • Run macbox doctor to check host KVM and Docker settings
  • Start the macOS virtual machine and show its current status
  • Provision the downloaded Xcode .xip inside the macbox instance

How to install macbox

1Skills CLI (Vercel)

npx skills add 0xdaniell/macbox --skill macbox -a claude-code

2Manually: put the files in place

~/.claude/skills/macbox/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/macbox/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about macbox

How to install macbox in Claude Code?

Run npx skills add 0xdaniell/macbox --skill macbox -a claude-code.

What does macbox do?

macbox runs a containerized macOS environment on Linux with GPU support, enabling iOS simulators and Xcode execution without a physical Mac.

What is required to run macbox?

You need a Linux system with KVM, Docker, a compatible GPU, and an Xcode .xip package downloaded from Apple's developer portal.

Similar skills

All skills for DevOps and infrastructure →

From the same set3

Project sponsors

Companies that keep this analytics open