Configure l’Agent CLI à l’aide du fichier cli-config.json.
| Type | Plateforme | Chemin |
|---|
| Global | macOS/Linux | ~/.cursor/cli-config.json |
| Global | Windows | $env:USERPROFILE\.cursor\cli-config.json |
| Projet | Tous | <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
| Champ | Type | Description |
|---|
version | number | Version du schéma de configuration (actuelle : 1) |
editor.vimMode | boolean | Activer les raccourcis Vim (par défaut : false) |
permissions.allow | string[] | Opérations autorisées (voir Permissions) |
permissions.deny | string[] | Opérations interdites (voir Permissions) |
| Champ | Type | Description |
|---|
model | object | Configuration du modèle sélectionné |
hasChangedDefaultModel | boolean | Indicateur de remplacement du modèle géré par la CLI |
{
"version": 1,
"editor": { "vimMode": false },
"permissions": { "allow": ["Shell(ls)"], "deny": [] }
}
{
"version": 1,
"editor": { "vimMode": true },
"permissions": { "allow": ["Shell(ls)"], "deny": [] }
}
{
"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.
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.
- 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)