Macbox

macbox

Um Mac real para seu agente de codificação. O macbox permite que Claude Code, Codex, Cursor ou qualquer cliente MCP compile, teste, execute e interaja com apps iOS nativos em um Mac real na nuvem, a partir de qualquer máquina, incluindo máquinas Linux e sandboxes de agentes em nuvem.

• Compile e teste: xcodebuild e seus testes XCTest e de UI, em um Mac mini rodando o Xcode mais recente. Seu agente recebe os resultados e as linhas de erro.
• Execute e interaja com o app: inicie-o no simulador de iOS, leia o que está na tela, toque, digite e deslize, para que seu agente possa verificar o próprio trabalho.
• Assista ao vivo: todo app em execução recebe um link de navegador onde você também pode assistir e usar.

Pague por minuto de Mac, apenas minutos inteiros: $0,05, e um trabalho com menos de um minuto é gratuito. Obtenha acesso e crédito gratuito em macbox.build.

Configuração

A maneira mais rápida: diga ao seu agente

Configure o macbox seguindo https://api.macbox.build/guide/

Ou escolha seu cliente:

Claude Code (plugin: skill + ferramentas MCP)

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

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

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

A CLI (macOS ou 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

Apenas a skill (Claude Code, Codex, Cursor, Gemini CLI, OpenCode e mais):

npx skills add opslane/macbox-agent

Se a CLI ainda não estiver configurada, a skill envia seu agente ao guia para instalá-la.

Faça login com macbox login, ou defina MACBOX_API_KEY (em um agente em nuvem, como um segredo de ambiente).

O que seu agente recebe

Ferramenta MCP	CLI	O que faz
build	macbox build	Compila para o simulador de iOS (ou macOS, para um app Mac)
test	macbox test	Executa testes em um simulador novo; uma linha PASS/FAIL por teste
screenshot	macbox screenshot	Inicia a última compilação e retorna uma imagem
run	macbox run	Inicia o app e o mantém em execução; retorna um link ao vivo
describe, tap, type, swipe, press_button, look	macbox ui ...	Usa o app em execução como uma pessoa
stop	macbox stop	Encerra o app em execução
report_problem	macbox feedback	Informa a equipe do macbox quando algo do nosso lado estiver errado

Para trabalhos mais avançados, também há macbox mcp --xcode: as ferramentas Xcode de código aberto do Sentry MobileBuildMCP (depuração LLDB, pacotes Swift, configurações do simulador), rodando no Mac do macbox.

Como funciona

macbox envia os arquivos rastreados pelo git (nunca arquivos .env a menos que você peça) para um Mac mini, dentro da sua própria VM macOS que só você usa e que não consegue acessar outras VMs nem nossa rede. Apenas arquivos alterados são enviados após a primeira vez, e o cache de compilação permanece, então a segunda compilação é rápida. Apps iOS nativos funcionam hoje: projetos e workspaces Xcode, pacotes Swift, CocoaPods, XcodeGen. Ainda não: assinatura, TestFlight, React Native, Flutter.

Guia completo: https://api.macbox.build/guide/ · Perguntas: Discord

Este repositório

As partes abertas do macbox: o plugin do Claude Code (.claude-plugin/, skills/, .mcp.json), o pacote npm macbox (npm/, que baixa a CLI de api.macbox.build e a verifica com os SHA256SUMS publicados) e a entrada do Registro MCP (server.json). O serviço macbox em si roda em nossos Macs.

Licenciado sob MIT.