.cursorignore
Propre à Cursor : .cursorignore liste les fichiers que l'éditeur ne doit ni indexer ni fournir à l'IA, comme les secrets. Ce que l'agent ne lit pas, il ne peut pas le divulguer.
- cursorignore
- cursor
- .env
- .venv
- node_modules
- secrets
Syntaxe
# .cursorignore (même syntaxe que .gitignore).env*!.env.example.venv/node_modules/*.db*.pem.next/Exemple
Demande : « résume la configuration du projet »Sans .cursorignore : l'agent ouvre .env et recopie DATABASE_URL dans sa réponse.Avec .cursorignore : .env n'est pas fourni à l'IA ; .env.example, sans secret, reste lisible.Résultat attendu : la réponse cite les noms des variables, jamais leurs valeurs.À retenir
- .gitignore ne suffit pas : un fichier non versionné reste lisible par l'éditeur et peut être indexé.
- Ignorez les secrets et les fichiers générés, pas le code métier : masquer src/ ou schema.prisma prive l'agent du contexte dont il a besoin.
- L'équivalent pour Claude Code est une règle deny sur Read dans .claude/settings.json (fiche « Garde-fous du dépôt »).
- Piège : croire que l'ignore est étanche. Cursor le présente comme une protection au mieux : une commande du terminal ou un outil MCP peut encore lire le fichier, d'où l'intérêt de hooks et d'une politique de commandes.
Voir aussi
- Garde-fous du dépôt (Claude Code et Cursor)Un dépôt confié à un agent se protège en couches : des consignes pour guider, des permissions pour interdire, des hooks pour contrôler chaque action et des fichiers ignorés pour cacher les secrets.
- Hooks d'agent (Cursor et Claude Code)Un hook est un petit programme que l'outil lance automatiquement à un moment précis, par exemple avant une commande shell : il peut l'autoriser, la bloquer avec un motif ou formater un fichier.
- Rules Cursor (.mdc)Propre à Cursor : une rule est un fichier .mdc de .cursor/rules/ qui porte les consignes d'un domaine. Son en-tête dit quand la charger : toujours, selon le chemin ou selon sa description.
- Injection de prompt par le dépôtTout ce que l'agent lit peut devenir une consigne : README, issue, page web, skill téléchargé. Un texte caché exigeant d'afficher .env est une attaque, que seules les règles de l'outil bloquent.