update-cli-config

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cursor CLI settings live in a JSON file with many options and internal fields that should not be touched. This Skill explains the full schema of ~/.cursor/cli-config.json so you can safely change permissions, approval modes, sandbox rules, and display options without breaking 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 on top of the home config, merged from git root to working directory for the current session only. - 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 approvalMode to unrestricted for a trusted project. Read the config, apply the two changes, write it back, and restart the CLI. ## 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?▼

Edit ~/.cursor/cli-config.json directly as standard JSON, then restart the CLI for changes to take effect. You can modify permissions, approvalMode, editor options like vimMode, display toggles, and sandbox settings.

How do I enable auto-approval for all Cursor CLI tool calls?▼

Set approvalMode to "unrestricted" in ~/.cursor/cli-config.json to auto-approve all tool calls. The default is "allowlist", which requires approval for tools not matching patterns in the permissions allow list.

Can I override Cursor CLI config per project?▼

Yes, create .cursor/cli.json files in your project. The CLI merges them from the git root down to the current directory, with deeper files taking precedence. Overrides apply only to the current session and are never written back to the home config.

Which Cursor CLI config fields should I not edit?▼

Avoid editing version, model, selectedModel, modelParameters, hasChangedDefaultModel, privacyCache, authInfo, showSandboxIntro, and conversationClassificationScoredConversations. These are internal or cached state 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 networkAllowlist to specify domains the sandbox is permitted to reach.