Documentation / Agents

GitHub Copilot

Mis à jour le

TL;DR — Pour la CLI Copilot, `tokenade install` écrit `~/.copilot/hooks/tokenade.json` et `~/.copilot/copilot-instructions.md`, et enveloppe `~/.copilot/mcp-config.json`. L'extension VS Code n'offre aucune surface de hook : seuls ses serveurs MCP sont repliés.

Tokenade couvre la CLI GitHub Copilot (copilot, du paquet @github/copilot) via ses hooks, avec l'ensemble des fonctions. L'extension Copilot de VS Code est un autre produit : elle n'expose aucun hook sur lequel Tokenade puisse se brancher. Seule l'optimisation MCP s'y applique, et les commandes tokenade s'utilisent à la main, ou par l'agent après lecture des règles.

CLI Copilot : ce que l'installation écrit

Copilot range ses fichiers dans ~/.copilot/ (%USERPROFILE%\.copilot\ sous Windows).

FichierCe que Tokenade ajoute
~/.copilot/hooks/tokenade.jsonUn fichier de hooks dédié (Tokenade ne modifie pas vos autres fichiers de hooks)
~/.copilot/copilot-instructions.mdUne courte section de règles Tokenade
~/.copilot/mcp-config.jsonLes serveurs MCP tiers, réécrits pour démarrer derrière tokenade mcp-wrap

Les hooks

ÉvénementRôle
PreToolUseRéécrit une commande shell pour la faire passer par tokenade wrap
postToolUseReplie les gros résultats d'outils avant que le modèle les lise
UserPromptSubmitNote de style avant chaque demande
SessionStartContexte de session
PreCompactS'exécute avant que Copilot compacte la conversation
subagentStartContexte des sous-agents

Chaque entrée porte un _tag qui commence par tokenade-copilot- : c'est ainsi que les mises à jour les rafraîchissent et que la désinstallation les retrouve. Comme tous les hooks Tokenade, ils ne bloquent jamais l'agent : si Tokenade est absent ou échoue, le hook se termine proprement.

Ce dont profite la CLI Copilot

Toutes les colonnes de la matrice de compatibilité sont couvertes : sorties de commandes, recherche web, résultats MCP, recherche dans le code, optimisation du contexte, dédup des relectures, documents et médias, masquage des secrets.

Hooks désactivés

Copilot respecte disableAllHooks dans ~/.copilot/config.json. S'il vaut true, aucun hook ne tourne, ceux de Tokenade compris. Depuis la 1.2.1, Tokenade lit cet interrupteur pour décider de ce que le proxy LLM doit couvrir.

Copilot dans VS Code

L'extension VS Code (GitHub.copilot / Copilot Chat) tourne à l'intérieur de VS Code, devant lequel Tokenade ne peut pas placer de hook. Ce que vous obtenez :

  • Optimisation MCP : tokenade mcp-wrap install enveloppe les serveurs MCP déclarés dans le mcp.json de VS Code (~/.config/Code/User/mcp.json sous Linux, ~/Library/Application Support/Code/User/mcp.json sous macOS, %APPDATA%\Code\User\mcp.json sous Windows). Voir Envelopper les serveurs MCP.
  • Commandes manuelles : recherche dans le code (tokenade map, skeleton, query, semantic), tokenade read pour les documents, tokenade wrap pour une commande bavarde, tokenade search pour le web. L'agent peut les appeler depuis son outil terminal quand les règles de votre projet les mentionnent.

Sorties de commandes, recherche web et lecture de documents sont donc partielles dans VS Code ; voir la ligne « Copilot dans VS Code » de la matrice de compatibilité.

Vérifier

tokenade healthcheck # vérifie que ~/.copilot/hooks/tokenade.json se résout et a la forme attendue
tokenade hooks tail # déclenchements récents
tokenade gain # registre des économies

Lancez ensuite une session de la CLI Copilot avec une commande bavarde et vérifiez que le registre grossit. Voir votre première session.

Retirer

tokenade uninstall --dry-run
tokenade uninstall

La désinstallation supprime ~/.copilot/hooks/tokenade.json, restaure vos serveurs MCP dans ~/.copilot/mcp-config.json et dans le mcp.json de VS Code, et retire la section de règles. Pour ne restaurer que les entrées MCP : tokenade unwrap-mcps. Voir Mettre à jour et désinstaller.

Voir aussi