CLI config
Settings
~/.cursor/cli-config.json
Vendor docs
config
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| approvalMode | string |
Approval mode: `allowlist`, `auto-review`, or `unrestricted`
|
docs ↗ | ||
| attribution.attributeCommitsToAgent | boolean |
Add "Made with Cursor" trailer to Agent commits (default: `true`)
|
docs ↗ | ||
| attribution.attributePRsToAgent | boolean |
Add "Made with Cursor" footer to Agent PRs (default: `true`)
|
docs ↗ | ||
| channel | string |
Release channel used for CLI updates
|
docs ↗ | ||
| display.showLineNumbers | boolean |
Show line numbers in rendered code blocks
|
docs ↗ | ||
| display.showStatusIndicators | boolean |
Enable terminal title status indicators
|
docs ↗ | ||
| display.showStatusLineRunningTime | boolean |
Show elapsed running time in the status line
|
docs ↗ | ||
| display.showThinkingBlocks | boolean |
Render model thinking blocks when available
|
docs ↗ | ||
| editor.vimMode | boolean | yes |
Enable Vim keybindings (default: `false`)
|
docs ↗ | |
| hasChangedDefaultModel | boolean |
CLI-managed model override flag
|
docs ↗ | ||
| hints | boolean |
Show CLI hints while the agent is working
|
docs ↗ | ||
| maxMode | boolean |
Persisted preference for max mode in the model picker
|
docs ↗ | ||
| model | object |
Selected model configuration
|
docs ↗ | ||
| network.useHttp1ForAgent | boolean |
Use HTTP/1.1 instead of HTTP/2 for agent connections (default: `false`)
|
docs ↗ | ||
| notifications | boolean |
Send a terminal notification when the agent finishes or needs input
|
docs ↗ | ||
| permissions.allow | array | yes |
Permitted operations (see Permissions)
|
docs ↗ | |
| permissions.deny | array | yes |
Forbidden operations (see Permissions)
|
docs ↗ | |
| rewind | boolean |
Enable `/rewind` to restore an earlier message in the session
|
docs ↗ | ||
| sandbox.mode | string |
Sandbox mode override
|
docs ↗ | ||
| sandbox.networkAccess | string |
Network access setting for sandbox mode
|
docs ↗ | ||
| suggestNextPrompt | boolean |
Suggest a follow-up prompt at the end of each turn
|
docs ↗ | ||
| version | number | yes |
Config schema version (current: `1`)
|
docs ↗ |