update-cli-config

View and modify Cursor CLI settings stored in cli-config.json.

Updated Oct 15, 2019
One-click install
npx skills add https://github.com/kkkaoru/dotfiles --skill update-cli-config-kkkaoru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-cli-config
Source: https://github.com/kkkaoru/dotfiles/tree/main/.cursor/skills-cursor/update-cli-config
Command: npx skills add https://github.com/kkkaoru/dotfiles --skill update-cli-config-kkkaoru

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Editing Cursor CLI preferences requires knowing the exact JSON schema of ~/.cursor/cli-config.json, which fields are safe to change, and which internal fields must be left alone. This Skill provides the full settings reference so configuration changes are made correctly without corrupting CLI state. ## Core Features & Use Cases - Settings Reference: Documents every configurable field including permissions, editor vim mode, display options, approval mode, sandbox, network, Bedrock, and attribution. - Project Overrides: Explains how .cursor/cli.json files layer per-project overrides on top of the home config without writing back to it. - Protected Fields: Lists internal cached state (version, model, authInfo, privacyCache) that must not be edited manually. - Use Case: A user wants to enable vim keybindings and auto-approve tool calls; the Skill identifies the editor.vimMode and approvalMode fields, applies the JSON edits, and notes that a CLI restart is required. ## Quick Start Update my Cursor CLI config to enable vim mode and show thinking blocks in the output.

Frequently Asked Questions about update-cli-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I change Cursor CLI settings?

Cursor CLI settings live in ~/.cursor/cli-config.json as standard JSON. Read the file, apply your changes to fields like permissions, editor, or display, write it back, and restart the CLI for changes to take effect.

How to enable vim mode in Cursor CLI?

Set editor.vimMode to true in ~/.cursor/cli-config.json. The editor section also supports defaultBehavior with values "ide" or "agent" to control the default behavior mode.

Can Cursor CLI config be overridden per project?

Yes, projects can layer overrides via .cursor/cli.json files. The CLI walks from the git root to the current directory and merges each file found, with deeper files taking precedence, and overrides are never written back to the home config.

How do I auto-approve tool calls in Cursor CLI?

Change approvalMode from the default "allowlist" to the Run Everything value, which auto-approves all tool calls like the --force or --yolo flags. You can also add patterns to permissions.allow for finer-grained control.

Which Cursor CLI config fields should not be edited?

Do not modify internal cached state: version, model, selectedModel, modelParameters, hasChangedDefaultModel, privacyCache, authInfo, showSandboxIntro, and conversationClassificationScoredConversations. These are managed by the CLI itself.

How do I configure sandbox network access in Cursor CLI?

Set sandbox.mode to "enabled" and choose a networkAccess policy: "user_config_only", "user_config_with_defaults", or "allow_all". Use sandbox.networkAllowlist to specify domains the sandbox is permitted to reach.