CompilePilot Companion

Qué necesitás

• Una Mac con Apple silicon.
• macOS 14 Sonoma o posterior.
• Xcode instalado, con sus herramientas de línea de comandos listas.
• CompilePilot en tu iPhone o iPad, y los dos dispositivos en la misma red local.

Cómo instalarlo

1. Descargá el DMG en tu Mac y abrilo.
2. Arrastrá CompilePilot Companion a Aplicaciones y abrilo desde ahí.
3. Buscá su ícono en la barra de menú: una computadora con un martillo.
4. En el iPhone o iPad, abrí CompilePilot, tocá Agregar Mac y buscá Macs cercanas.
5. Hacé clic en el ícono de la barra de menú e ingresá en la app el código de seis dígitos que muestra.

Qué agrega sobre SSH

• Tu Mac aparece solaSe anuncia en la red local, así que no hace falta escribir un hostname ni una IP.
• Los builds no dependen de la pantallaPodés salir de la pantalla del build y volver: sigue corriendo, y te avisa cuando termina.
• Simulator en vivoMirás el simulador de la Mac y lo tocás desde el teléfono, con gestos, teclado y botones.
• Sesiones de agenteAbre Claude Code, Codex u opencode —los que tengas instalados— sobre el proyecto que elegiste, en una terminal propia. Varias a la vez, y siguen trabajando aunque salgas de la pantalla. Necesita CompilePilot 3.0.
• Compilar con XcodeAdemás de xcodebuild, compilás, corrés y testeás con el propio Xcode, con el switch «Compilar con Xcode» de la pantalla de run.
• Previews de SwiftUILas renderiza Xcode en la Mac y las ves en el teléfono. Con Xcode 27 no hace falta tener Xcode abierto; con Xcode 26.3 o posterior, sí, y ese modo se puede apagar desde la ventana del Companion.
• La Mac no se duerme a mitad de un buildMientras trabaja —un build, un agente, el Simulator— el Companion evita que la Mac entre en reposo por inactividad. Lo elegís en su ventana: nunca, mientras trabaja o siempre.
• Sin permisos del sistemaLee el framebuffer del simulador por CoreSimulator: no pide Accesibilidad ni Grabación de Pantalla. Preparar las herramientas de Xcode sí pide la contraseña de administrador en la Mac: se hace una vez, para todas las carpetas de proyectos del Companion, desde la pantalla de la Mac en el teléfono.

Actualizaciones

El Companion se actualiza solo. Cada versión se publica firmada, y la app instala una actualización únicamente si esa firma coincide con la clave que trae adentro. También podés pedírselo vos: hacé clic en el ícono de la barra de menú y elegí «Buscar actualizaciones…».

Si algo no aparece

• Si no ves el ícono en la barra de menú, fijate que no haya quedado escondido detrás del notch: cerrá alguna otra app de la barra o revisá Configuración del Sistema → Barra de menús.
• Si el iPhone no encuentra la Mac, confirmá que los dos estén en la misma red Wi-Fi y que el Companion esté abierto. La primera búsqueda puede pedirte el permiso de red local.
• Si el Companion avisa que Xcode no está listo, seguí lo que te ofrece en su ventana de estado: instalarlo, seleccionarlo o abrirlo para que termine de configurarse.
• Si un agente aparece como no instalado, el Companion lo busca donde lo encuentra tu Terminal. Confirmá que en la Terminal de la Mac el comando del agente funcione.

Tu código no sale de tu Mac

El Companion habla con tu propio dispositivo, por tu red local. No hay cuenta ni relay: el emparejamiento se inicia en la Mac, y el token queda en el Keychain de cada lado. Si activás los avisos fuera de casa, el Companion manda cada uno cifrado a un servidor nuestro, que se lo pasa a Apple sin poder leerlo. Un agente que abras habla con su propio proveedor, con tu cuenta, igual que cuando lo usás en la Mac.

¿Y si no querés instalar nada?

CompilePilot funciona sin el Companion: se conecta por SSH con Remote Login activado, y compila, prueba, distribuye y muestra git igual. El Companion hace falta para el Simulator interactivo, las sesiones de agente, compilar con Xcode y las previews.