Langsung ke konten utama
Atur Agent CLI menggunakan file cli-config.json.

​
Lokasi file

TipePlatformPath
GlobalmacOS/Linux~/.cursor/cli-config.json
GlobalWindows$env:USERPROFILE\.cursor\cli-config.json
ProyekSemua<project>/.cursor/cli.json
Cuma izin yang bisa dikonfigurasi di level proyek. Semua pengaturan CLI lainnya harus diatur secara global.
Override dengan variabel lingkungan:
  • CURSOR_CONFIG_DIR: path direktori kustom
  • XDG_CONFIG_HOME (Linux/BSD): memakai $XDG_CONFIG_HOME/cursor/cli-config.json

​
Skema

​
Field wajib

FieldTypeDeskripsi
versionnumberVersi skema konfigurasi (saat ini: 1)
editor.vimModebooleanMengaktifkan keybinding Vim (default: false)
permissions.allowstring[]Operasi yang diizinkan (lihat Permissions)
permissions.denystring[]Operasi yang dilarang (lihat Permissions)

​
Field opsional

FieldTypeDeskripsi
modelobjectKonfigurasi model yang dipilih
hasChangedDefaultModelbooleanFlag override model yang dikelola CLI

​
Contoh

​
Konfigurasi minimal

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

​
Aktifkan Mode Vim

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

​
Konfigurasikan izin

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": {
    "allow": ["Shell(ls)", "Shell(echo)"],
    "deny": ["Shell(rm)"]
  }
}
Lihat Permissions untuk jenis izin yang tersedia dan contohnya.

​
Pemecahan Masalah

Error konfigurasi: Pindahin file-nya dulu ke lokasi lain, lalu restart: 
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
Perubahan nggak tersimpan: Pastikan JSON valid dan punya izin tulis. Beberapa field dikelola CLI dan bisa ke-overwrite.

​
Catatan

  • Format JSON murni (tanpa komentar)
  • CLI melakukan perbaikan otomatis untuk field yang hilang
  • File yang rusak dicadangkan sebagai .bad dan dibuat ulang
  • Entri izin harus berupa string yang persis sama (lihat Permissions untuk detail)