Macbox

macbox

Una Mac real para tu agente de código. macbox permite que Claude Code, Codex, Cursor o cualquier cliente MCP compile, pruebe, ejecute e interactúe con apps nativas de iOS en una Mac real en la nube, desde cualquier máquina, incluidas cajas Linux y sandboxes de agentes en la nube.

• Compila y prueba: xcodebuild y tus pruebas XCTest y UI, en una Mac mini con el Xcode más reciente. Tu agente recibe los resultados y las líneas de error.
• Ejecuta y maneja la app: ábrela en el simulador de iOS, lee lo que hay en pantalla, toca, escribe y desliza, para que tu agente pueda verificar su propio trabajo.
• Mírala en vivo: cada app en ejecución obtiene un enlace de navegador donde también puedes verla y usarla.

Paga por minuto de Mac, solo minutos completos: $0.05, y un trabajo de menos de un minuto es gratis. Obtén acceso y crédito gratis en macbox.build.

Configuración

La forma más rápida: dile a tu agente

Configura macbox siguiendo https://api.macbox.build/guide/

O elige tu cliente:

Claude Code (plugin: skill + herramientas MCP)

claude plugin marketplace add opslane/macbox-agent
claude plugin install macbox@macbox

Cualquier cliente MCP (Codex, Cursor, Claude Desktop, VS Code, ...), con Node 18+:

{
  "mcpServers": {
    "macbox": { "command": "npx", "args": ["-y", "macbox", "mcp"] }
  }
}

La CLI (macOS o Linux):

curl -fsSL https://api.macbox.build/install.sh | sh
macbox login
macbox setup      # installs the skill for Claude Code and Codex, and notes in CLAUDE.md / AGENTS.md

Solo la skill (Claude Code, Codex, Cursor, Gemini CLI, OpenCode y más):

npx skills add opslane/macbox-agent

Si la CLI aún no está configurada, la skill envía a tu agente a la guía para instalarla.

Inicia sesión con macbox login, o configura MACBOX_API_KEY (en un agente en la nube, como secreto de entorno).

Lo que obtiene tu agente

Herramienta MCP	CLI	Qué hace
build	macbox build	Compila para el simulador de iOS (o macOS, para una app de Mac)
test	macbox test	Ejecuta pruebas en un simulador nuevo; una línea PASS/FAIL por prueba
screenshot	macbox screenshot	Abre la última compilación y devuelve una imagen
run	macbox run	Abre la app y la mantiene en ejecución; devuelve un enlace en vivo
describe, tap, type, swipe, press_button, look	macbox ui ...	Usa la app en ejecución como una persona
stop	macbox stop	Termina la app en ejecución
report_problem	macbox feedback	Avisa al equipo de macbox cuando algo de nuestro lado falla

Para trabajo más profundo también está macbox mcp --xcode: las herramientas Xcode de MobileBuildMCP de código abierto de Sentry (depuración con LLDB, paquetes Swift, ajustes del simulador), ejecutándose en la Mac de macbox.

Cómo funciona

macbox envía los archivos que git rastrea (nunca archivos .env a menos que lo pidas) a una Mac mini, dentro de tu propia VM de macOS que solo tú usas y que no puede alcanzar otras VMs ni nuestra red. Solo se envían los archivos modificados después de la primera vez, y la caché de compilación se mantiene, así que la segunda compilación es rápida. Las apps nativas de iOS funcionan hoy: proyectos y workspaces de Xcode, paquetes Swift, CocoaPods, XcodeGen. Aún no: firma, TestFlight, React Native, Flutter.

Guía completa: https://api.macbox.build/guide/ · Preguntas: Discord

Este repositorio

Las partes abiertas de macbox: el plugin de Claude Code (.claude-plugin/, skills/, .mcp.json), el paquete npm macbox (npm/, que descarga la CLI desde api.macbox.build y la verifica contra los SHA256SUMS publicados), y la entrada del Registro MCP (server.json). El servicio de macbox en sí se ejecuta en nuestras Macs.

Licencia MIT.