frontmatter

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 ↗