GitHub Copilot

GitHub Copilot est le fournisseur avec lequel OAR démarre : il est toujours disponible et utilise la CLI Copilot connectée sur l’hôte du relais. Le relais le fait tourner sur l’un de deux moteurs. Le moteur SDK est celui par défaut et vous offre le pilotage, un panneau pour les tâches de fond et des questions à choix multiple. Le moteur d’extension fait tourner la vraie CLI Copilot dans un terminal que vous pouvez observer.

OpenAI avec votre propre clé tourne sur les deux mêmes moteurs : les sections de cette page consacrées aux moteurs s’y appliquent donc aussi. Sa clé et ses modèles sont sur la page OpenAI.

Ce qu’il vous faut #

• La CLI Copilot, connectée, sur l’hôte du relais. Installez-la avec npm install -g @github/copilot, lancez copilot une fois et connectez-vous. Votre compte GitHub doit avoir un forfait Copilot qui inclut Copilot CLI.
• Un redémarrage du relais après avoir installé ou mis à niveau la CLI. Le relais cherche le runtime de la CLI à son démarrage et ne voit pas une installation faite plus tard.
• La CLI GitHub (gh), connectée, pour oar copilot, les sessions du moteur d’extension sous Windows et la carte Copilot de Check Usage (Vérifier la consommation).
• tmux (facultatif, Linux et macOS) si vous voulez observer le terminal d’une session avec 🖥️ Inspect tmux console (Inspecter la console tmux).

Le relais n’installe ni ne met à jour la CLI Copilot. Dans Settings → Providers → Copilot (Réglages → Fournisseurs → Copilot), la ligne GitHub Copilot CLI en haut se contente d’indiquer son état.

Comment OAR trouve la CLI #

Le moteur SDK pilote le runtime fourni avec la CLI Copilot. Au démarrage, le relais regarde dans le cache de paquets de la CLI et prend la version la plus récente qui s’y trouve :

Sous Linux, les deux dossiers suivent XDG_CACHE_HOME et XDG_DATA_HOME quand vous les définissez. Définissez COPILOT_PKG_DIR pour ajouter un dossier à explorer, ou COPILOT_SDK_PATH pour désigner directement le dossier copilot-sdk du runtime. Si rien n’est trouvé, le moteur SDK n’est pas disponible (voir Choisir le moteur).

Utiliser oar copilot #

oar copilot démarre le relais en arrière-plan si aucun ne répond sur son port, puis ouvre la CLI Copilot (gh copilot) dans votre shell. Un relais qu’il a démarré s’arrête de nouveau à la fin de la session. Les arguments placés après -- vont à gh copilot.

oar copilot
oar copilot --port 3400 -- --help

Chaque exécution écrit ou rafraîchit aussi un petit wrapper dans ~/.copilot/extensions/web-relay/, une extension globale à l’utilisateur qui charge l’extension d’OAR dans la CLI Copilot. oar copilot --install-extension ne fait que cela et se termine (il n’a pas besoin de gh) ; --no-install-extension saute cette étape pour une exécution. Si gh manque, oar copilot le signale et s’arrête ; installez la CLI GitHub ou ne lancez que le relais avec oar start.

Les deux moteurs #

Les deux moteurs affichent le même fil de la conversation, les mêmes cartes de question, tableaux de plan, liste de modèles et ligne de consommation par réponse. Voir Les turns et la queue pour Steer, Queue (Mettre en file) et les fenêtres de turn bloqué, Modes du relais et Compactage pour ces lignes, et ask_user pour les cartes de question.

Sur le moteur SDK, Stop ne met fin qu’à la réponse. Les agents en arrière-plan lancés par le turn continuent de tourner sous leur propre Stop dans le panneau des tâches.

Choisir le moteur #

Le choix est un seul réglage pour tout le relais : Settings → Providers → Copilot → Copilot engine (Réglages → Fournisseurs → Copilot → Moteur Copilot), avec les options Extension et SDK — default (SDK — par défaut). Appuyez sur Save Copilot settings (Enregistrer les réglages Copilot) après l’avoir changé.

• Il s’applique aux conversations dont le worker démarre ensuite. Une session déjà en cours garde son moteur jusqu’au redémarrage de son worker.
• Si personne n’a enregistré de choix, le relais utilise SDK chaque fois qu’il le peut et Extension quand il ne le peut pas. Un choix que vous avez enregistré l’emporte toujours. Cela vaut aussi pour un SDK enregistré : si un redémarrage ultérieur ne trouve plus la CLI, le relais ne revient pas en arrière de lui-même, et le worker d’une nouvelle conversation ne peut pas démarrer tant que la CLI n’est pas retrouvée ou que vous n’enregistrez pas Extension.
• Le panneau indique quel moteur est réglé : New Copilot conversations run on the headless SDK worker. No tmux inspector for these sessions. ou New Copilot conversations run on the Copilot CLI with the web-relay extension.

Pour savoir quel moteur utilise une conversation en cours, regardez sa zone de saisie et sa console tmux. Pendant un turn, le bouton d’envoi affiche Steer sur le moteur SDK (il y affiche Queue tant qu’une carte de question ou une approbation est ouverte, que le turn compacte ou qu’un appel d’outil tourne) et toujours Queue sur le moteur d’extension. La console tmux n’affiche un écran Copilot que sur le moteur d’extension. La conversation elle-même ne porte pas d’étiquette de moteur.

Quand l’enregistrement de SDK est refusé #

Le relais refuse d’enregistrer SDK quand il ne pourrait pas le faire tourner, et affiche la raison à la place de la description du moteur. Le réglage enregistré ne change pas, et la liste de choix revient au moteur que le relais fait réellement tourner.

Réglages #

Sous Settings → Providers → Copilot :

D’autres réglages qui touchent les sessions Copilot se trouvent ailleurs :

Modèles #

Le relais lit la liste des modèles dans le runtime de la CLI Copilot installé quelques secondes après son démarrage. Chaque modèle affiche les efforts de raisonnement et la fenêtre de contexte que le runtime annonce. La liste commence par auto, puis regroupe les modèles par éditeur (OpenAI, Anthropic, Google, xAI, Microsoft, Azure OpenAI, Moonshot AI, puis les autres par ordre alphabétique), la version la plus récente en premier.

Jusqu’à la première découverte, un nouveau relais propose gpt-5.4, gpt-5.4-mini (le modèle par défaut), gpt-5.3-codex, claude-sonnet-4.6 et claude-haiku-4.5.

Utilisez 🤗 Select Models → Copilot (Sélectionner des modèles → Copilot) dans le menu ⋯ d’une conversation pour choisir quels modèles apparaissent dans la zone de saisie, puis 💾 Save enabled models (Enregistrer les modèles activés). Refresh (Actualiser) relit la liste. Si la liste paraît ancienne, appuyez sur Refresh.

Consommation #

• Sous une réponse, un turn Copilot indique ce qu’il a consommé : +N pour les crédits, avec la part de votre forfait mensuel entre parenthèses, et month N% left. Une étiquette stale signifie que les chiffres n’ont pas pu être actualisés pour ce turn. Seuls les turns Copilot ont cette ligne ; les autres fournisseurs, OpenAI compris, n’utilisent pas de crédits Copilot.
• Dans l’en-tête, une ligne de session fait le total de la conversation, par exemple Session: 1.25 AIC used.
• Dans Check Usage, ouvrez 📊 Check Usage dans le menu ⋯ et choisissez l’onglet Copilot pour le quota en direct (crédits d’IA ou requêtes premium, chat et forfait). Sur le moteur SDK, il ajoute Last SDK worker turn : les crédits que ce turn a réellement dépensés, ses tokens et ses appels au modèle. Ce sont les chiffres d’un seul turn, pas un total cumulé, et la section disparaît au bout de sept jours.

La carte Copilot lit votre compte via gh. Si vous n’utilisez pas gh, définissez GH_TOKEN ou GITHUB_TOKEN dans l’environnement du relais.

Importer les sessions que vous avez déjà #

Au démarrage, le relais importe les sessions Copilot enregistrées sur l’hôte, pour qu’elles apparaissent dans votre liste avec leur historique. Il les lit via le runtime Copilot installé. Si le runtime n’est pas disponible, l’import est signalé comme échoué. Le relais ne devine rien à partir des fichiers.

Supprimer une telle session ne fait que la masquer : la session propre à la CLI Copilot reste, car le relais ne l’a jamais fait tourner.

Variables d’environnement #

Définissez-les dans l’environnement du processus du relais, puis redémarrez le relais.

Limites #

• Le relais a besoin d’un redémarrage pour remarquer une CLI Copilot installée ou mise à niveau après son démarrage.
• Sur le moteur SDK, il n’y a pas de terminal auquel se rattacher.
• Les messages envoyés pendant un turn vont en queue sur le moteur d’extension ; ils ne peuvent pas piloter le turn.
• Sur le moteur SDK, le relais accorde à un turn 2 minutes de silence quand rien ne tourne, 5 minutes pendant une requête au modèle et 30 minutes pendant qu’un outil tourne, avant de faire échouer le turn. Un turn qui attend une carte de question n’est jamais considéré comme bloqué. Les fenêtres sont décrites dans Les turns et la queue.
• Une conversation OpenAI sur votre propre clé utilise aussi ces moteurs, mais dépense votre clé : ses turns n’ont donc pas de ligne de consommation Copilot.

Si ça ne marche pas #

Les sessions d’agent, les modes du relais et les autres comportements qui ne dépendent pas du moteur fonctionnent comme décrit dans les pages sur les sessions et sur les agents qui travaillent ensemble.