Configure l’Agent CLI avec le fichier cli-config.json.

​
Emplacement du fichier

TypePlateformeChemin
GlobalmacOS/Linux~/.cursor/cli-config.json
GlobalWindows$env:USERPROFILE\.cursor\cli-config.json
ProjetTous<project>/.cursor/cli.json
Seules les autorisations peuvent être configurées au niveau du projet. Tous les autres paramètres du CLI doivent être définis globalement.
Surcharger avec des variables d’environnement :
  • CURSOR_CONFIG_DIR : chemin de répertoire personnalisé
  • XDG_CONFIG_HOME (Linux/BSD) : utilise $XDG_CONFIG_HOME/cursor/cli-config.json

​
Schéma

​
Champs requis

ChampTypeDescription
versionnumberVersion du schéma de configuration (actuelle : 1)
editor.vimModebooleanActiver les raccourcis clavier Vim (par défaut : false)
permissions.allowstring[]Opérations autorisées (voir Permissions)
permissions.denystring[]Opérations interdites (voir Permissions)

​
Champs optionnels

ChampTypeDescription
modelobjectConfiguration du modèle sélectionné
hasChangedDefaultModelbooleanIndicateur de remplacement du modèle géré par la CLI

​
Exemples

​
Config minimale

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": { "allow": ["Shell(ls)"], "deny": [] }
}

​
Activer le mode Vim

{
  "version": 1,
  "editor": { "vimMode": true },
  "permissions": { "allow": ["Shell(ls)"], "deny": [] }
}

​
Configurer les autorisations

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": {
    "allow": ["Shell(ls)", "Shell(echo)"],
    "deny": ["Shell(rm)"]
  }
}
Voir Autorisations pour les types d’autorisations disponibles et des exemples.

​
Dépannage

Erreurs de config : Déplace le fichier ailleurs et redémarre : 
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
Les changements ne persistent pas : Vérifie que le JSON est valide et que tu as les droits d’écriture. Certains champs sont gérés par le CLI et peuvent être écrasés.

​
Notes

  • Format JSON pur (sans commentaires)
  • Le CLI effectue une auto‑réparation des champs manquants
  • Les fichiers corrompus sont sauvegardés avec l’extension .bad puis recréés
  • Les entrées d’autorisations doivent correspondre exactement aux chaînes (voir Permissions pour plus de détails)