Si l’agent de Background de Cursor ne fonctionne pas du tout sur GitHub, la raison la plus courante n’est pas que le modèle se bloque, mais que les conditions d’accès côté GitHub ne soient pas remplies. La documentation officielle de Cursor est désormais simple : Agents de fond et Bugbot s’appuient tous deux sur l’application GitHub de Cursor pour cloner des dépôts, créer des branches et pousser des modifications.
En d’autres termes, tant que l’application GitHub n’est pas correctement installée, que les permissions correspondantes du dépôt ne sont pas obtenues, ou que l’organisation a activé la liste IP mais ne la publie pas, même si l’agent backend peut cliquer sur l’interface, il est facile de se retrouver bloqué dans des problèmes tels que « pas lu le dépôt », « pas d’autorisation de pousser PR » ou « le déclencheur de commentaire ne répond pas ».
Il y a maintenant trois couches qui risquent d’être manquées. Premièrement, l’application GitHub n’est installée que dans le compte, pas dans l’organisation cible ni dans le dépôt cible. Deuxièmement, le dépôt privé n’a pas suffisamment d’autorisations, et l’agent peut voir le problème mais ne peut pas obtenir le code. Troisièmement, l’organisation active la liste d’IP autorisée, mais n’autorise pas les applications GitHub à hériter de la liste préconfigurée ni à ajouter manuellement des IP à partir de la documentation du curseur.
L’ordre correct de l’enquête est recommandé comme suit :
1. Rendez-vous sur la page d’intégration GitHub de Cursor pour confirmer que votre compte est bien connecté.
2. Rendez-vous sur GitHub pour confirmer que la portée d’installation de l’application Cursor inclut le dépôt cible.
3. S’il s’agit d’un dépôt privé, vérifiez si les autorisations de lecture/écriture et d’écriture PR sont accordées.
4. Si votre organisation a configuré une liste d’IP autorisée, activez d’abord « Autoriser l’accès par GitHub Apps », et vous ne pouvez pas ajouter manuellement d’IP.
Si vous déclenchez l’agent de gestion via un commentaire cursor, vérifiez à nouveau les règles de protection des branches. Souvent, l’agent fonctionne réellement, mais il n’a pas la permission de pousser les changements vers la branche cible, donc il ressemble à « aucun mouvement du tout ».
Par conséquent, la façon de juger de tels problèmes est très simple : tant que le rapport d’erreur se concentre sur le clonage, l’accès au dépôt, l’envoi de commits et la rédaction de commentaires PR, prioriser l’application GitHub et la publication réseau, et ne pas traîner avec les paramètres locaux de Cursor au préalable. Le goulot d’étranglement clé de l’agent de fond est souvent absent du tout dans l’éditeur.
