Documentation / Agents
Cursor
Mis à jour le
Cursor est couvert par ses hooks programmables : Tokenade réécrit les commandes shell et les lectures de fichiers de l'agent avant leur exécution, et replie les gros résultats d'outils MCP à leur retour. tokenade install met cela en place dès qu'il trouve un dossier ~/.cursor, en conservant les hooks que vous aviez déjà.
Ce que l'installation écrit
~ désigne votre dossier personnel (%USERPROFILE% sous Windows) ; les chemins sont les mêmes sous Linux, macOS et Windows.
| Fichier | Ce que Tokenade ajoute |
|---|---|
~/.cursor/hooks.json | Une entrée preToolUse et une entrée postToolUse (ci-dessous) |
~/.cursor/rules/tokenade.mdc | Une courte section de règles Tokenade, chargée dans chaque session Cursor |
.cursor/mcp.json (projet), ~/.cursor/mcp.json (global) | Les serveurs MCP tiers, réécrits pour démarrer derrière tokenade mcp-wrap |
Les hooks
| Hook | Ce qu'il fait |
|---|---|
preToolUse | Réécrit une commande shell en tokenade wrap <cmd> pour que sa sortie revienne compactée ; redirige la lecture d'un gros fichier vers une copie repliée |
postToolUse | Remplace un gros résultat d'outil MCP par une version repliée (Cursor ne permet aux hooks de remplacer que les résultats MCP) |
La fusion est idempotente : une entrée Tokenade existante est mise à jour sur place, jamais dupliquée, et les entrées qui ne sont pas à Tokenade restent intactes. Les mises à jour rafraîchissent ces hooks automatiquement.
Les programmes interactifs (éditeurs, pagers, top, ssh…) ne sont jamais enveloppés : leur sortie serait redirigée et ils ne rendraient jamais la main.
Ce dont profite Cursor
D'après la matrice de compatibilité : sorties de commandes, recherche web, résultats MCP, recherche dans le code, dédup des relectures, documents et médias, et masquage des secrets sont couverts. L'optimisation de la fenêtre de contexte est partielle sur Cursor.
Règles : le fichier .mdc de ~/.cursor/rules/ est celui que Cursor charge globalement. Cursor lit aussi CLAUDE.md et AGENTS.md dans un projet ; Tokenade n'y répète donc pas ses règles complètes quand une copie globale existe.
Après l'installation
Redémarrez Cursor (ou rechargez la fenêtre) pour qu'il prenne en compte le nouveau hooks.json et la configuration MCP. Demandez ensuite à l'agent de lancer quelque chose de bavard, comme votre suite de tests.
Vérifier
tokenade hooks tail # déclenchements récents, y compris ceux de Cursor
tokenade gain # économies enregistrées dans ~/.tokenade/gain.jsonl
Vous pouvez aussi ouvrir ~/.cursor/hooks.json et y chercher les deux commandes tokenade. tokenade detect, lancé depuis un projet Cursor, affiche cursor et son canal.
Désactiver ou retirer
| Objectif | Comment |
|---|---|
| Lancer une commande sans compaction | tokenade raw <cmd> |
| Restaurer seulement les entrées MCP d'origine | tokenade unwrap-mcps |
| Installer pour Cursor seulement, sur une machine à plusieurs agents | tokenade install --only cursor |
| Tout retirer | tokenade uninstall |
tokenade uninstall supprime de ~/.cursor/hooks.json chaque entrée qui mentionne Tokenade, restaure vos serveurs MCP et retire le fichier de règles qu'il avait écrit. Prévisualisez d'abord avec tokenade uninstall --dry-run. Voir Mettre à jour et désinstaller.