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
npx skills add 0xdaniell/macbox --skill macbox -a claude-codeWhat 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 doctorto check host KVM and Docker settings - Start the macOS virtual machine and show its current status
- Provision the downloaded Xcode
.xipinside the macbox instance
How to install macbox
1Skills CLI (Vercel)
npx skills add 0xdaniell/macbox --skill macbox -a claude-code2Manually: put the files in place
~/.claude/skills/macbox/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/macbox/
1Skills CLI (Vercel)
npx skills add 0xdaniell/macbox --skill macbox -a codex2Manually: put the files in place
.agents/skills/macbox/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add 0xdaniell/macbox --skill macbox -a cursor2Manually: put the files in place
.cursor/skills/macbox/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install 0xdaniell/macbox src/skills/macbox2Manually: put the files in place
.github/skills/macbox/SKILL.md1Skills CLI (Vercel)
npx skills add 0xdaniell/macbox --skill macbox -a gemini-cli2Platform CLI
gemini skills install https://github.com/0xdaniell/macbox --path src/skills/macboxManually: put the files in place
.devin/skills/macbox/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.