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
ProjetToutes<project>/.cursor/cli.json
Seules les autorisations peuvent être configurées au niveau du projet. Tous les autres paramètres de la CLI doivent être définis globalement.
Remplacer via 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 config (actuelle : 1)
editor.vimModebooleanActiver les raccourcis 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

Configuration 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 configuration : Mets le fichier de côté puis redémarre :
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
Les modifications ne sont pas conservées : Vérifie que le JSON est valide et que tu as les droits d’écriture. Certains champs sont gérés par la CLI et peuvent être écrasés.

Notes

  • Format JSON pur (pas de commentaires)
  • Le CLI se répare automatiquement pour les champs manquants
  • Les fichiers corrompus sont sauvegardés en .bad puis recréés
  • Les entrées d’autorisations sont des chaînes exactes (voir Permissions pour plus de détails)