CompilePilot Support

Before you connect

1. On your Mac, open System Settings → General → Sharing and enable Remote Login.
2. Make sure your iPhone or iPad can reach the Mac on the same local network or through your tailnet.
3. In CompilePilot, enter the Mac hostname or IP address, SSH port, and Mac username.

Pairing the Companion

The Companion is optional and free. With it there is no address to type, builds keep running when you leave the screen, and interactive Simulator, agent sessions, and previews are enabled.

1. Download the DMG on the Mac, open it, and drag CompilePilot Companion to Applications. Open it from there.
2. Look for its menu bar icon: a computer with a hammer.
3. On your iPhone or iPad, open CompilePilot, tap Add a Mac, and search for nearby Macs. The first search may ask for Local Network permission.
4. Click the menu bar icon and enter the six-digit code it shows into the app.

• If you cannot see the icon, check that it has not been pushed behind the notch: quit another menu bar app, or look at System Settings → Menu Bar.
• If your iPhone cannot find the Mac, confirm both are on the same Wi-Fi network and the Companion is open.
• If the Companion says Xcode is not ready, follow what its status window offers.

Building with Xcode, agents, and previews

• Building with Xcode, previews, and Xcode tools for agents are set up once for the whole Mac: in the app, open the Mac and, under “Xcode Tools”, tap “Prepare on Mac”. Someone at the Mac has to enter an administrator password.
• If an agent shows as not installed, the Companion looks for it where your Terminal finds it. Open Terminal on the Mac and check that the agent’s command works there, then tap Check again in the app.
• The session runs with your own agent account. If it asks you to sign in, do it from the session itself, as you would on the Mac.
• Previews and Xcode tools for agents need Xcode 26.3 or later. With Xcode 26, Xcode must be open and asks on the Mac whether to allow access; with Xcode 27 it does not need to be open.
• If a preview says the project is not allowed, tap Run on Mac: the Companion applies the missing step and macOS asks for an administrator password on the Mac.
• If the Mac sleeps during a build, check “Keep this Mac awake” in the Companion’s window. With the lid closed, or Sleep from the Apple menu, the Mac still sleeps.

If something fails

• Verify the Mac is awake and Remote Login is still enabled.
• Try the same address and credentials from another SSH client.
• Review the raw command and complete build log in CompilePilot.
• With Tailscale, confirm both devices are connected and access rules allow SSH.