XToGo

Support

Report a problem — replies usually within a couple of days.

Getting set up

1. Create a key in App Store Connect

Xcode Cloud can't be reached with an Apple ID — a key is the only way in, and that's Apple's rule, not ours. In App Store Connect, go to Users and Access → Integrations → App Store Connect API and create a key. Give it a role that can see Xcode Cloud; if you want to start builds from the app, it needs write access too.

Download the key file straight away — Apple allows exactly one download, and there is no way to get it back later. Note the issuer ID shown at the top of the page and the key ID in the key's row.

2. Add it in XToGo

Open Settings → Add account and start with the key file: tap Choose .p8 File and pick the one you downloaded. If it still has the name App Store Connect gave it — AuthKey_XXXXXXXXXX.p8 — the key ID fills itself in, so the issuer ID is the only thing left to paste. Name the account if you like, and that's the whole of setup.

Do this once. With iCloud on, the account reaches your other Apple devices by itself, so the Mac is already set up by the time you open it. With iCloud off, add the key on each device.

3. Switch teams

A key belongs to one team, so add one per team. Switch between them from the account menu in the navigation bar and everything on screen follows.

When something looks wrong

"Not authorised" or an empty app list

Usually the key's role. Confirm in App Store Connect that it's allowed to see Xcode Cloud, and that the issuer ID and key ID came from the same page as the key file you downloaded.

Start Build is unavailable

Two things switch it off. Starting builds is part of XToGo Pro, so the free version offers the purchase instead. With Pro, it's the key: read-only keys can look but not touch, so create one that's allowed to write to Xcode Cloud, or start the build from Xcode instead.

A run's issue counts show "—"

That's not a bug. Counts are reported for each step of a run, not for the run as a whole, so open a step to see its errors, warnings, analyzer warnings and test failures. A dash means nobody told us a number — better than showing four zeroes that were never counted.

A running build isn't updating

A run that hasn't finished refreshes itself every few seconds. Nothing pushes updates the instant they happen, so pull to refresh if you'd rather not wait.

An account I added elsewhere hasn't turned up

Syncing needs the same Apple Account on both devices, with iCloud Keychain and iCloud Drive turned on in system settings. It can also just be slow — iCloud decides when to deliver. If it still hasn't arrived, add the key on that device yourself; nothing is lost by doing so.

XToGo Pro

The free version holds one team and shows your first two apps, with every screen behind them — runs, actions, issues, tests, artifacts and the full logs. Pro adds the rest of your apps, as many teams as you work with, and starting builds from the app. Monthly, yearly, or a one-off lifetime purchase.

A purchase belongs to your Apple Account, not to a device, so it's already there when you open the app on the iPad or the Mac. If it isn't, open the paywall — from any locked feature — and tap Restore Purchases. Subscriptions are managed in the App Store, under your account's Subscriptions; XToGo can't cancel one for you.

Removing an account

Deleting an account in XToGo removes it and its key, on that device and the others it synced to. Deleting the app removes everything else, including any artifacts it downloaded. If the key itself should stop working, revoke it in App Store Connect — that is the only place a key can be revoked.

Requirements

Still stuck?

Report a problem, or find me on X. The same form is in the app under Settings › Report a Problem, where it arrives with your app version already filled in. Please say which system version you are on and what you were doing at the time. Never send the key file itself — it is never needed to work out what went wrong.