Configura la Agent CLI usando el archivo cli-config.json.
| Tipo | Plataforma | Ruta |
|---|
| Global | macOS/Linux | ~/.cursor/cli-config.json |
| Global | Windows | $env:USERPROFILE\.cursor\cli-config.json |
| Proyecto | Todas | <project>/.cursor/cli.json |
Solo los permisos pueden configurarse a nivel de proyecto. Todos los demás ajustes de la CLI deben configurarse globalmente.
Sobrescribir con variables de entorno:
CURSOR_CONFIG_DIR: ruta de directorio personalizada
XDG_CONFIG_HOME (Linux/BSD): usa $XDG_CONFIG_HOME/cursor/cli-config.json
| Campo | Tipo | Descripción |
|---|
version | number | Versión del esquema de configuración (actual: 1) |
editor.vimMode | boolean | Activar keybindings de Vim (por defecto: false) |
permissions.allow | string[] | Operaciones permitidas (consulta Permissions) |
permissions.deny | string[] | Operaciones no permitidas (consulta Permissions) |
| Campo | Tipo | Descripción |
|---|
model | object | Configuración del modelo seleccionado |
hasChangedDefaultModel | boolean | Indicador de override del modelo gestionado por 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)"]
}
}
Consulta Permissions para conocer los tipos de permisos disponibles y ver ejemplos.
Errores de configuración: Mueve el archivo a otro lado y reinicia:
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
Los cambios no persisten: Asegúrate de que el JSON sea válido y de tener permisos de escritura. Algunos campos los gestiona la CLI y pueden sobrescribirse.
- Formato JSON puro (sin comentarios)
- La CLI se autorrepara cuando faltan campos
- Los archivos dañados se respaldan como
.bad y se vuelven a crear
- Las entradas de permisos deben coincidir exactamente con la cadena (consulta Permisos para más detalles)