Настрой Agent CLI с помощью файла cli-config.json.

​
Расположение файла

ТипПлатформаПуть
ГлобальныйmacOS/Linux~/.cursor/cli-config.json
ГлобальныйWindows$env:USERPROFILE\.cursor\cli-config.json
ПроектВсе<project>/.cursor/cli.json
На уровне проекта можно настраивать только permissions. Все остальные параметры CLI задаются глобально.
Переопределение через переменные окружения:
  • CURSOR_CONFIG_DIR: пользовательский путь к каталогу
  • XDG_CONFIG_HOME (Linux/BSD): используется $XDG_CONFIG_HOME/cursor/cli-config.json

​
Схема

​
Обязательные поля

ПолеТипОписание
versionnumberВерсия схемы конфигурации (текущая: 1)
editor.vimModebooleanВключить сочетания клавиш Vim (по умолчанию: false)
permissions.allowstring[]Разрешённые операции (см. Permissions)
permissions.denystring[]Запрещённые операции (см. Permissions)

​
Необязательные поля

ПолеТипОписание
modelobjectНастройка выбранной модели
hasChangedDefaultModelbooleanФлаг переопределения модели, управляемый CLI

​
Примеры

​
Минимальная конфигурация

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

​
Включить режим Vim

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

​
Настройка разрешений

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": {
    "allow": ["Shell(ls)", "Shell(echo)"],
    "deny": ["Shell(rm)"]
  }
}
Смотри раздел Permissions для доступных типов разрешений и примеров.

​
Устранение неполадок

Ошибки конфигурации: Перемести файл в другое место и перезапусти: 
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
Изменения не сохраняются: Проверь, что JSON валиден и есть права на запись. Некоторые поля управляются CLI и могут быть перезаписаны.

​
Примечания

  • Чистый JSON (без комментариев)
  • CLI автоматически восстанавливает отсутствующие поля
  • Повреждённые файлы сохраняются с суффиксом .bad и создаются заново
  • Значения разрешений — точные строковые литералы (см. Permissions для деталей)