O que xcode-cli faz?
Plugin Claude Code: Controle o Xcode pelo Claude — compile, teste, execute, limpe, gerencie simuladores, esquemas, projetos e dispositivos. Mais de 30 comandos via AppleScript + xcodebuild + xcrun.
🚀 Recursos
- Compilar projetos com
xcodebuild - Testar esquemas específicos
- Executar aplicativos em simuladores ou dispositivos
- Limpar pastas de build e derivados
- Gerenciar simuladores (criar, excluir, iniciar, parar)
- Listar dispositivos conectados
- Alterar esquemas ativos
- Abrir projetos e espaços de trabalho no Xcode
📦 Instalação
Adicione o plugin ao seu projeto Claude Code:
claude add-tool marcelrgberger/xcode-cli
🔧 Pré-requisitos
- macOS com Xcode 15.0+ instalado
- Ferramentas de linha de comando do Xcode configuradas (
xcode-select --install) - Permissão de acessibilidade para AppleScript (caso use comandos que interajam com a interface gráfica)
📖 Comandos
| Comando | Descrição | Implementação |
|---|---|---|
build | Compila o projeto ativo | xcodebuild |
test | Executa testes no esquema especificado | xcodebuild test |
run | Executa o aplicativo no simulador | AppleScript + simctl |
clean | Limpa a pasta de build | xcodebuild clean |
simctl | Gerencia simuladores | xcrun simctl |
list-devices | Lista dispositivos conectados | xcrun xctrace list devices |
open | Abre o projeto no Xcode | open -a Xcode |
scheme | Define ou lista esquemas | xcodebuild -list |
archive | Cria um archive | xcodebuild archive |
export | Exporta um archive para IPA | xcodebuild -exportArchive |
💻 Exemplos de Uso
Compilar um projeto:
Claude, compile o projeto atual para iOS Simulator.
Executar testes:
Claude, execute os testes do esquema 'MeuApp'.
Gerenciar simuladores:
Claude, liste todos os simuladores disponíveis e inicie o iPhone 15.
Limpar builds:
Claude, limpe os builds do projeto atual.
⚙️ Configuração
O plugin detecta automaticamente o projeto Xcode no diretório atual. Você pode especificar um projeto ou workspace explicitamente com variáveis de ambiente:
XCODE_PROJECT: caminho para o arquivo.xcodeprojXCODE_WORKSPACE: caminho para o arquivo.xcworkspaceXCODE_SCHEME: nome do esquema padrãoXCODE_DESTINATION: destino de build (ex.:platform=iOS Simulator,name=iPhone 15)
🤝 Contribuição
Contribuições são bem-vindas! Envie Pull Requests ou abra Issues no repositório do GitHub.
📄 Licença
MIT