# Cursor

> Comment Tokenade se branche sur Cursor : hooks preToolUse et postToolUse dans ~/.cursor/hooks.json, enveloppe MCP, fichier de règles, vérification et retrait.

Source: https://tokenade.net/fr/docs/cursor · Updated: 2026-10-07

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é](https://tokenade.net/fr/docs/compatibility) : 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

```bash
tokenade healthcheck     # vérifie que les hooks de chaque agent sont installés et valides
tokenade hooks tail      # déclenchements récents, y compris ceux de Cursor
tokenade dashboard       # rapport local des économies, dans votre navigateur
```

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](https://tokenade.net/fr/docs/upgrade-uninstall).

## Voir aussi

- [Comment les hooks interceptent les appels d'outils](https://tokenade.net/fr/docs/hooks)
- [Envelopper les serveurs MCP](https://tokenade.net/fr/docs/mcp-wrap)
- [Agents pris en charge et compatibilité](https://tokenade.net/fr/docs/compatibility)
- [Dépannage](https://tokenade.net/fr/docs/troubleshooting)
- Article : [Réduire la consommation de tokens de Cursor](https://tokenade.net/fr/articles/reduce-cursor-token-usage)
