Need a hand with Cumulus? Happy to help.
Contact
Send an email and you'll get an answer, usually within a couple of days.
Tip: for a specific issue, mention your macOS version and the version of Cumulus (Settings › General). Never send your API key or your .p8 file by email: nobody needs it to help you.
Frequently asked
Where do I get the API key?
In App Store Connect, open Users and Access › Integrations › App Store Connect API, Team Keys tab, and create a key. Give it App Manager access to start builds from Cumulus, or Developer access to only read them. Copy the Issuer ID and the Key ID, download the .p8 file (Apple offers it only once), and give all three to Cumulus. Only the Account Holder or an Admin of the team can create a team key.
Is my key safe?
It is stored in the macOS Keychain on your Mac and only signs the requests your Mac sends to Apple. Cumulus has no server and no account. See the Privacy Policy.
Why is my usage an estimate?
Apple's API exposes neither the minutes used nor the plan. Cumulus estimates the minutes from the duration of your builds, and marks them with a “~”. For the minutes Apple really billed, export the usage file from App Store Connect (Users and Access › Xcode Cloud › Usage) into your Downloads folder: Cumulus imports it on its own, and the figures of the builds it lists become exact.
Where do I find my plan and its reset date?
On the same page, Users and Access › Xcode Cloud › Usage: the number of hours and the reset date are at the top. Type them in Settings, in your account.
The Cumulus icon is not in the menu bar
When the menu bar is full, macOS hides the icons that do not fit. Quit an app that has one or remove an icon you do not use, and Cumulus appears. You can also show Cumulus in the Dock from Settings › General.
Can Cumulus start a build?
Yes, when the key's access is set to “Read + Build” in your account's settings and the key's role allows it. Every launch asks for confirmation. Set it to “Read only” and Cumulus never writes anything in App Store Connect.
I follow several teams
Add one account per team in Settings, each with its own key. All of them stay up to date and notify you; the menu and the window show the one you select.
How do I use Cumulus from an AI agent?
Settings › Agents installs the cumulus command and its skill, and gives the line that registers the MCP server for Claude Code, Codex, Xcode and Claude Desktop. The command and the server read what the app already knows; they never see your key.
How do I remove everything?
In Settings, open the account and delete it: its key leaves the Keychain and its data leaves your Mac. Then revoke the key in App Store Connect so that it cannot be used anywhere.
Requirements
A Mac running macOS 27 or later, and an App Store Connect team that uses Xcode Cloud.
Links
Cumulus is an independent app. It is not affiliated with Apple. Xcode Cloud and App Store Connect are trademarks of Apple Inc.
Besoin d'aide avec Cumulus ? Avec plaisir.
Contact
Écris un e-mail, la réponse arrive en général sous quelques jours.
Astuce : pour un problème précis, indique ta version de macOS et celle de Cumulus (Réglages › Général). N'envoie jamais ta clé API ni ton fichier .p8 par e-mail : personne n'en a besoin pour t'aider.
Questions fréquentes
Où trouver la clé API ?
Dans App Store Connect, ouvre Utilisateurs et accès › Intégrations › API App Store Connect, onglet Clés d'équipe, et crée une clé. Donne-lui l'accès App Manager pour lancer des builds depuis Cumulus, ou Développeur pour seulement les lire. Copie l'Issuer ID et le Key ID, télécharge le fichier .p8 (Apple ne le propose qu'une fois), et donne les trois à Cumulus. Seul le titulaire du compte ou un administrateur de l'équipe peut créer une clé d'équipe.
Ma clé est-elle en sécurité ?
Elle est stockée dans le trousseau de macOS, sur ton Mac, et ne sert qu'à signer les requêtes que ton Mac envoie à Apple. Cumulus n'a ni serveur ni compte. Voir la politique de confidentialité.
Pourquoi ma consommation est-elle une estimation ?
L'API d'Apple ne donne ni les minutes utilisées ni le forfait. Cumulus estime les minutes d'après la durée de tes builds, et les marque d'un « ~ ». Pour les minutes qu'Apple a vraiment facturées, exporte le fichier d'usage depuis App Store Connect (Utilisateurs et accès › Xcode Cloud › Utilisation) dans ton dossier Téléchargements : Cumulus l'importe tout seul, et les chiffres des builds qu'il liste deviennent exacts.
Où trouver mon forfait et sa date de réinitialisation ?
Sur la même page, Utilisateurs et accès › Xcode Cloud › Utilisation : le nombre d'heures et la date de réinitialisation sont en haut. Saisis-les dans les Réglages, dans ton compte.
L'icône de Cumulus n'est pas dans la barre des menus
Quand la barre des menus est pleine, macOS masque les icônes qui ne tiennent pas. Quitte une app qui en a une ou retire une icône dont tu ne te sers pas, et Cumulus apparaît. Tu peux aussi afficher Cumulus dans le Dock depuis Réglages › Général.
Cumulus peut-il lancer un build ?
Oui, quand l'accès de la clé est réglé sur « Lecture + Build » dans les réglages de ton compte et que le rôle de la clé le permet. Chaque lancement demande une confirmation. Règle-le sur « Lecture seule » et Cumulus n'écrit jamais rien dans App Store Connect.
Je suis plusieurs équipes
Ajoute un compte par équipe dans les Réglages, chacun avec sa clé. Tous restent à jour et te notifient ; le menu et la fenêtre montrent celui que tu sélectionnes.
Comment utiliser Cumulus depuis un agent IA ?
Réglages › Agents installe la commande cumulus et son skill, et donne la ligne qui enregistre le serveur MCP pour Claude Code, Codex, Xcode et Claude Desktop. La commande et le serveur lisent ce que l'app sait déjà ; ils ne voient jamais ta clé.
Comment tout supprimer ?
Dans les Réglages, ouvre le compte et supprime-le : sa clé quitte le trousseau et ses données quittent ton Mac. Révoque ensuite la clé dans App Store Connect pour qu'elle ne puisse plus servir nulle part.
Configuration requise
Un Mac sous macOS 27 ou ultérieur, et une équipe App Store Connect qui utilise Xcode Cloud.
Liens
Cumulus est une app indépendante. Elle n'est pas affiliée à Apple. Xcode Cloud et App Store Connect sont des marques d'Apple Inc.