Configura el Agent CLI con el archivo cli-config.json.

​
Ubicación del archivo

TipoPlataformaRuta
GlobalmacOS/Linux~/.cursor/cli-config.json
GlobalWindows$env:USERPROFILE\.cursor\cli-config.json
ProyectoTodas<project>/.cursor/cli.json
Solo los permisos pueden configurarse a nivel de proyecto. Todas las demás opciones de la CLI deben establecerse globalmente.
Anular con variables de entorno:
  • CURSOR_CONFIG_DIR: ruta de directorio personalizada
  • XDG_CONFIG_HOME (Linux/BSD): usa $XDG_CONFIG_HOME/cursor/cli-config.json

​
Esquema

​
Campos obligatorios

CampoTipoDescripción
versionnumberVersión del esquema de configuración (actual: 1)
editor.vimModebooleanHabilita los keybindings de Vim (predeterminado: false)
permissions.allowstring[]Operaciones permitidas (ver Permissions)
permissions.denystring[]Operaciones prohibidas (ver Permissions)

​
Campos opcionales

CampoTipoDescripción
modelobjectConfiguración del modelo seleccionado
hasChangedDefaultModelbooleanIndicador de override del modelo gestionado por la CLI

​
Ejemplos

​
Configuración mínima

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

​
Activar el modo Vim

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

​
Configurar permisos

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": {
    "allow": ["Shell(ls)", "Shell(echo)"],
    "deny": ["Shell(rm)"]
  }
}
Consulta Permisos para ver los tipos de permisos disponibles y ejemplos.

​
Solución de problemas

Errores de configuración: Mueve el archivo a un 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.

​
Notas

  • Formato JSON puro (sin comentarios)
  • La CLI repara automáticamente los campos faltantes
  • Los archivos dañados se respaldan como .bad y se vuelven a crear
  • Las entradas de permisos son cadenas exactas (consulta Permissions para más detalles)