Trier votre boîte de réception

Ce guide vous montre comment travailler dans la boîte de réception : la surface unique qui rassemble tout ce qui vous bloque ou vous sollicite explicitement — approbations d’agent en attente, synchronisations de tickets en échec et chaque pull request qui vous concerne comme relecteur ou auteur.

Ouvrir la boîte de réception

1. Cliquez sur Boîte de réception dans la barre latérale. Son badge compte les approbations d’agent en attente, les synchronisations en échec et les PR ouvertes en attente de votre revue.
2. Ou appuyez sur ⌘K et lancez la commande de navigation Boîte de réception.
3. Ou ouvrez directement l’URL /workspaces/<workspace-id>/inbox.

L’entrée de la barre latérale affiche toujours le compteur en direct : vous voyez donc le travail de tri s’accumuler sans ouvrir la page.

Lire la sévérité d’un coup d’œil

Parcourez la liste de haut en bas ; la boîte de réception est déjà classée par urgence :

1. La bande épinglée Requiert votre attention se trouve au-dessus des sections de PR. Chaque carte porte une puce de sévérité. Les sources enregistrées (un agent bloqué sur une demande de confirmation, une synchronisation de tickets dont le miroir chez le fournisseur est obsolète) produisent Bloqué.
2. Dans la bande, la sévérité la plus urgente vient en premier ; à égalité, c’est l’élément qui attend depuis le plus longtemps qui passe devant.
3. Sous la bande, les PR sont regroupées dans des sections fixes du cycle de vie de la revue — En attente de votre revue, Renvoyées vers vous, Approuvées, Brouillons, En attente de relecteurs, En cours de fusion et récemment fusionnées, En attente de l’auteur. Les premières sections sont ce qui vous attend vous ; les autres indiquent où en sont vos PR. En attente de votre revue inclut les PR qui sollicitent encore une équipe à laquelle vous appartenez, sur les forges qui les prennent en charge (GitHub retire l’équipe dès qu’un coéquipier a relu).

Un élément n’arrive dans la boîte de réception que s’il bloque quelque chose ou vous sollicite explicitement. Une bande vide et une liste de sections vide n’affichent Vous êtes à jour que lorsque ce vide est fiable.

Une seule boîte de réception pour toutes les forges

Si l’espace de travail contient des dépôts sur plusieurs hébergeurs de code, la boîte de réception les fusionne en un seul flux — une pull request GitHub et une pull request Bitbucket se retrouvent dans la même section, classées par date plutôt que regroupées par fournisseur. C’est la métadonnée repo #number de la ligne qui permet de les distinguer.

Ce qui vous appartient est déterminé forge par forge, car vous êtes un compte différent sur chacune. Une pull request n’est considérée comme la vôtre, ou comme demandant votre revue, que si elle correspond à votre identité sur la forge où ce dépôt réside réellement.

Une forge hors service ou non connectée n’apporte rien et laisse le reste de la boîte de réception intact — une connexion en panne ne vide jamais toute la liste. L’état vide signale une réserve au lieu d’afficher Vous êtes à jour lorsque aucun identifiant de forge n’est encore résolu (Impossible de confirmer votre compte GitHub — le texte nomme toujours GitHub), lorsque githubstatus.com signale un incident, ou lorsqu’une installation de GitHub App couvrant des dépôts liés est suspendue.

Vider la bande d’attention

Chaque carte de la bande propose une seule action suivante :

1. Si une carte correspond à une confirmation d’agent en attente, cliquez sur Examiner — vous arrivez dans l’espace de cet agent avec sa confirmation en attente. Approuvez ou refusez à cet endroit (voir Discuter avec un agent).
2. Si une carte indique Échec de la synchronisation pour un fournisseur, cliquez sur Ouvrir — vous arrivez sur Réglages → Espace de travail → Général, dont la carte État de la synchronisation affiche la dernière synchronisation de chaque connexion, sa série d’échecs consécutifs et son dernier résultat. Seul le dernier échec de chaque fournisseur apparaît dans la boîte de réception : une synchronisation rétablie efface donc la carte.
3. Les cartes disparaissent d’elles-mêmes dès que l’état sous-jacent est résolu (l’agent a sa réponse, la synchronisation est rétablie) — il n’y a rien à écarter manuellement.

Ces confirmations valent pour un tour, ce ne sont pas des approbations de gouvernance

Une carte « approbation d’agent » correspond à un agent en cours d’exécution qui se met en pause pour demander l’autorisation d’une action, dans sa propre conversation. C’est tout autre chose que l’enregistrement de gouvernance Approval que les agents créent avec les outils MCP d’approbation — ceux-ci n’ont aucun écran humain dans l’application et n’apparaissent jamais ici.

L’état de la synchronisation est en lecture seule

La carte rend compte des connexions de synchronisation de tickets ; hormis un bouton Synchroniser, elle ne permet pas d’en créer, d’en modifier ni d’en reconnecter une, et aucun autre écran ne le permet non plus. Sans aucune connexion configurée, elle affiche simplement « Aucune connexion de synchronisation », ce que montre un espace de travail fraîchement créé.

Filtrer sur ce qui bloque

1. Appuyez sur f (quand aucun champ de texte n’a le focus) pour ouvrir le menu de filtres, ou cliquez sur le bouton de filtre dans la barre d’outils.
2. Choisissez n’importe quelle combinaison de statut, auteur, relecteurs, contenu, propriétaire/nom du dépôt, plages de dates ou rapide à relire. Les compteurs de facettes du menu indiquent combien d’éléments de la boîte de réception correspondent à chaque option.
3. Les filtres actifs apparaissent sous forme de pastilles dans la barre au-dessus de la liste ; cliquez sur le ✕ d’une pastille pour retirer ce critère.
4. Utilisez le rail de gauche pour passer d’une section à l’autre — chaque entrée affiche son compteur en direct et la surbrillance suit votre position de défilement. Cliquez sur l’en-tête d’une section pour replier les sections que vous ne triez pas (par exemple Brouillons pendant que vous traitez les revues).
5. Cliquez sur un en-tête de colonne (titre, modifications ou mise à jour) pour trier toutes les sections ; cliquez à nouveau sur la colonne active pour inverser le sens. Le bouton des options d’affichage contrôle la visibilité des brouillons, la fenêtre des fusions récentes, les propriétés des lignes, l’ordre et le regroupement (seul le regroupement par auteur change la disposition de la boîte de réception).

Les filtres de cette page sont indépendants de la file des PR — restreindre la boîte de réception ne modifie jamais les filtres de la file, et inversement.

Agir sur un élément de PR

1. Cliquez sur n’importe quelle ligne pour ouvrir la page de détail de la PR.
2. Si la PR est dans En attente de votre revue, examinez-la et soumettez votre décision — voir Examiner et fusionner une PR.
3. Si la PR est dans Renvoyées vers vous (modifications demandées ou échec de la CI), poussez des correctifs depuis votre copie locale ou confiez le suivi à un agent.
4. Si la PR est dans Approuvées, fusionnez-la depuis la page de détail.
5. Si vous préférez déléguer une revue plutôt que de la faire vous-même, voir Lancer des agents relecteurs et le cycle de vie du lancement.

Dès que l’état sous-jacent change (votre revue est déposée, la PR est fusionnée), le classificateur reclasse automatiquement la PR dans sa nouvelle section.

Annuler une action par erreur

1. Appuyez sur ⌘Z pour annuler la dernière action, sur ⌘⇧Z pour la rétablir.
2. Si un champ de texte a le focus, ⌘Z modifie le texte du champ à la place — cliquez hors du champ pour annuler une action au niveau de l’application.

Consulter les raccourcis sur place

Appuyez sur ? (quand aucun champ de texte n’a le focus) pour ouvrir l’aide-mémoire des raccourcis clavier. Il liste chaque raccourci actif sur la route courante, y compris le raccourci de filtre f de la boîte de réception. La carte complète se trouve dans la référence des raccourcis clavier.

Piloter depuis la palette de commandes

1. Appuyez sur ⌘K n’importe où pour ouvrir la palette de commandes.
2. Saisissez Boîte de réception pour accéder à la page, ou saisissez le titre d’une PR — la palette liste les pull requests correspondantes et ouvre celle que vous choisissez.
3. Quand la boîte de réception est ouverte, lancez Copier le lien de cette page pour copier cette URL en vue de la partager. La commande copie la route courante : elle ne correspond donc à l’URL de la boîte de réception que lorsque vous êtes sur cette page.

Actualiser à la demande

La boîte de réception se met à jour en direct, mais si vous soupçonnez des données obsolètes, cliquez sur la commande d’actualisation dans la barre d’outils — elle force un balayage immédiat côté serveur de chaque forge connectée et recharge les superpositions relatives aux fusions et aux revues. L’icône tourne jusqu’à ce que toutes les requêtes soient terminées.

Guides connexes

• Examiner et fusionner une PR
• Discuter avec un agent
• Lancer des agents relecteurs

Concepts connexes

• Cycle de vie du lancement