Saltar al contenido principal
Configura la Agent CLI usando 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. 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

Esquema

Campos obligatorios

CampoTipoDescripción
versionnumberVersión del esquema de configuración (actual: 1)
editor.vimModebooleanActivar keybindings de Vim (por defecto: false)
permissions.allowstring[]Operaciones permitidas (consulta Permissions)
permissions.denystring[]Operaciones no permitidas (consulta 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": [] }
}

Habilitar 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 Permissions para conocer los tipos de permisos disponibles y ver ejemplos.

Solución de problemas

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.

Notas

  • 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)
I