Настрой 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 для подробностей)