update-cli-config

View and modify Cursor CLI configuration settings in the cli-config.json file.

Updated May 28, 2023
One-click install
npx skills add https://github.com/steveulrich/ProjectB --skill update-cli-config-steveulrich
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-cli-config
Source: https://github.com/steveulrich/ProjectB/tree/main/.cursor/skills/update-cli-config
Command: npx skills add https://github.com/steveulrich/ProjectB --skill update-cli-config-steveulrich

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cursor CLI settings are stored in a JSON file with many options and internal fields that should not be touched. This Skill guides safe viewing and editing of ~/.cursor/cli-config.json so you can change permissions, approval mode, display options, sandbox, and other preferences without corrupting internal state. ## Core Features & Use Cases - Settings Reference: Documents every configurable field including permissions, editor, display, approvalMode, sandbox, network, bedrock, and attribution. - Project Overrides: Explains how .cursor/cli.json files layer project-level overrides on top of the home config for the current session. - Protected Fields: Lists internal/cached fields (version, model, authInfo, privacyCache) that must not be edited manually. - Use Case: You want to enable vim mode and switch approval mode to unrestricted for a trusted project. The Skill reads the config, applies the JSON changes, and tells you to restart the CLI for them to take effect. ## Quick Start Ask the assistant to enable vim mode and show thinking blocks in your Cursor CLI configuration.

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?▼

Edit the ~/.cursor/cli-config.json file, which is standard JSON, then restart the CLI for changes to take effect. You can modify permissions, editor options, display settings, approval mode, sandbox, and more.

How to enable vim mode in Cursor CLI?▼

Set the vimMode boolean to true under the editor section of ~/.cursor/cli-config.json. Restart the CLI after saving the file and vim keybindings will be active in the CLI input.

Can I override CLI config per project?▼

Yes, projects can layer overrides via .cursor/cli.json files. The CLI walks from the git root to the current working directory and merges each file found, with deeper files taking precedence, and overrides only affect the current session.

What is the difference between allowlist and unrestricted approval mode?▼

The allowlist mode (default) requires approval for any tool call not matching an allow pattern in permissions. The unrestricted mode auto-approves all tool calls, which is a yolo-style mode suited only for trusted environments.

Which cli-config.json fields should not be edited?▼

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