Passer au contenu principal
Configure l’Agent CLI à l’aide du 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 réglages du 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 configuration (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 permissions

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

Dépannage

Erreurs de configuration : Mets le fichier de côté et redémarre :
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
Les modifications ne sont pas conservées : Assure-toi que le JSON est valide et que tu as les autorisations d’écriture. Certains champs sont gérés par la CLI et peuvent être écrasés.

Notes

  • Format JSON pur (sans commentaires)
  • La CLI répare automatiquement 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)
I