# macbox

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 149 repo stars
- Author: 0xdaniell
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/0xdaniell/macbox/tree/HEAD/src/skills/macbox/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/macbox

## What it 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.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add 0xdaniell/macbox --skill macbox -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/macbox/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/macbox/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add 0xdaniell/macbox --skill macbox -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/macbox/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add 0xdaniell/macbox --skill macbox -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/macbox/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install 0xdaniell/macbox src/skills/macbox
```

2. **Manually: put the files in place**
- File: `.github/skills/macbox/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add 0xdaniell/macbox --skill macbox -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/0xdaniell/macbox --path src/skills/macbox
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/macbox/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/0xdaniell/macbox/tree/HEAD/src/skills/macbox/SKILL.md

## When to use it
- 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
- 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

## Similar
- [devboxes](https://affpapa.org/en/nevibecode/skills/devboxes.md) — skill · 3100 installs
- [docker-platform-guide](https://affpapa.org/en/nevibecode/skills/docker-platform-guide.md) — skill · 192 installs
- [windows-vm](https://affpapa.org/en/nevibecode/skills/windows-vm.md) — skill · 285 installs
- [axiom-build](https://affpapa.org/en/nevibecode/skills/axiom-build.md) — skill · 1400 installs
- [asc-xcode-build](https://affpapa.org/en/nevibecode/skills/asc-xcode-build.md) — skill · 8000 installs
- [app-store-preflight-skills](https://affpapa.org/en/nevibecode/skills/app-store-preflight-skills.md) — skill · 2200 installs

From the same set: [0xdaniell/macbox](https://affpapa.org/en/nevibecode/by/0xdaniell/macbox.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
