`cli-config.json (configurarea Cursor CLI) și /config` în Cursor IDE

Cursor CLI (agent) Cursor CLI (2026)

Configurația Cursor CLI stă în ~/.cursor/cli-config.json; la nivel de proiect se pot seta doar permisiunile, în .cursor/cli.json.

Sintaxă & invocare

~/.cursor/cli-config.json (global) | <project>/.cursor/cli.json (doar permisiuni) | /config

Ce face `cli-config.json (configurarea Cursor CLI) și /config`

Setările globale stau în ~/.cursor/cli-config.json (pe Windows $env:USERPROFILE\.cursor\cli-config.json). La nivel de proiect, <project>/.cursor/cli.json acceptă doar permisiuni. CURSOR_CONFIG_DIR schimbă directorul, iar pe Linux și BSD XDG_CONFIG_HOME duce la $XDG_CONFIG_HOME/cursor/cli-config.json. În sesiune, /config deschide setările interactiv.

Câmpuri obligatorii: version (acum 1), editor.vimMode, permissions.allow, permissions.deny. Fișierul este JSON pur, fără comentarii. CLI-ul completează singur câmpurile lipsă, iar un fișier corupt este salvat ca .bad și recreat. Unele câmpuri sunt gestionate de CLI și pot fi suprascrise.

Pentru proxy setezi HTTP_PROXY, HTTPS_PROXY, NODE_USE_ENV_PROXY=1 și, la inspecție SSL, NODE_EXTRA_CA_CERTS. Dacă proxy-ul nu suportă streaming HTTP/2 bidirecțional, pui network.useHttp1ForAgent pe true.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
`version`	Versiunea schemei (acum `1`). Obligatoriu.
`editor.vimMode`	Taste Vim (implicit `false`). Obligatoriu.
`permissions.allow / permissions.deny`	Operațiuni permise / interzise. Obligatorii.
`channel`	Canalul de lansare pentru actualizări.
`model`	Configurația modelului ales.
`maxMode`	Preferința pentru Max Mode din selectorul de modele.
`hasChangedDefaultModel`	Indicator gestionat de CLI.
`notifications`	Notificare în terminal când agentul termină sau are nevoie de tine.
`hints`	Indicii afișate cât lucrează agentul.
`rewind`	Activează `/rewind`.
`suggestNextPrompt`	Propune un prompt următor la finalul fiecărei ture.
`display.showLineNumbers`	Numere de linie în blocurile de cod.
`display.showThinkingBlocks`	Afișează blocurile de gândire, când există.
`display.showStatusIndicators`	Indicatori de stare în titlul terminalului.
`display.showStatusLineRunningTime`	Timpul scurs în linia de stare.
`approvalMode`	`allowlist`, `auto-review` sau `unrestricted`.
`sandbox.mode`	Suprascrierea modului sandbox.
`sandbox.networkAccess`	Accesul la rețea în sandbox.
`sandbox.readBoundary`	`system` (implicit) sau `workspace`.
`network.useHttp1ForAgent`	HTTP/1.1 în loc de HTTP/2 (implicit `false`).
`attribution.attributeCommitsToAgent`	Adaugă trailerul „Made with Cursor” la commiturile agentului (implicit `true`).
`attribution.attributePRsToAgent`	Adaugă subsolul „Made with Cursor” la PR-urile agentului (implicit `true`).

Exemple practice

Exemplul 1: Configurație minimă

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

Exemplul 2: Recuperare după o configurație stricată

mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad

Greșeli frecvente și bune practici

Pui setări ca model sau editor.vimMode în .cursor/cli.json din proiect. Acolo se citesc doar permisiunile.
Adaugi comentarii în fișier. Configurația trebuie să fie JSON pur.

Ce face cli-config.json (configurarea Cursor CLI) și /config