skills.rest
nthpaul
nthpaulCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

update-cli-config

Edit ~/.cursor/cli-config.json to configure Cursor CLI settings.

Updated May 18, 2025
Search Tags:#permissions#json#sandbox#cursor#cli configuration#approval mode#vim mode
One-click install
npx skills add https://github.com/nthpaul/dotfiles --skill update-cli-config-nthpaul
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-cli-config
Source: https://github.com/nthpaul/dotfiles/tree/main/cursor/.cursor/skills-cursor/update-cli-config
Command: npx skills add https://github.com/nthpaul/dotfiles --skill update-cli-config-nthpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Updating Cursor CLI settings without guessing where to make changes or which options apply can lead to misconfigured permissions, confusing UI behavior, and inconsistent agent/tool approvals.

Core Features & Use Cases

  • Inspect and edit CLI configuration for Cursor’s home-level settings stored in ~/.cursor/cli-config.json.
  • Apply feature-specific changes such as permissions rules, vim mode, display toggles, release channel, approval mode, sandbox/network constraints, and model/agent-related settings.
  • Plan around layered overrides by using project .cursor/cli.json files for session-only behavior while keeping the home config as the baseline (changes take effect after restarting the CLI).

Quick Start

Ask the skill to update ~/.cursor/cli-config.json to enable vim mode, switch approvalMode to allowlist, and turn on showLineNumbers while keeping permissions intact.

Frequently Asked Questions about update-cli-config

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

FAQPage Schema
How do I configure Cursor CLI settings like vim mode and permissions?▼

You can configure Cursor CLI behavior by modifying the JSON settings file at ~/.cursor/cli-config.json. This file controls editor behavior like vim mode, display options, and permissions, requiring a CLI restart to apply changes.

What is the difference between home-level CLI configuration and project-level overrides in Cursor?▼

Home-level CLI configuration in ~/.cursor/cli-config.json acts as the baseline, whereas project .cursor/cli.json files provide session-only overrides. You use both to plan layered configuration changes for Cursor CLI behavior.

How do I change the approval mode in Cursor CLI to use an allowlist?▼

To change the approval mode, you edit ~/.cursor/cli-config.json and set the approvalMode value to allowlist. This restricts agent and tool approvals to explicitly permitted actions within your Cursor CLI environment.

Can I update Cursor CLI release channel and network settings using a JSON config file?▼

Yes, you can update the release channel and network settings by editing the ~/.cursor/cli-config.json file. All changes must follow Cursor's documented JSON option schema to ensure proper configuration of sandbox and network constraints.

Why are my Cursor CLI configuration changes not working after editing the JSON file?▼

Cursor CLI configuration changes are not applied immediately because they require restarting the CLI to take effect. Ensure your JSON modifications follow Cursor's documented option schema and are saved in ~/.cursor/cli-config.json before restarting.

Do I need to manually edit JSON to manage sandbox and attribution settings in Cursor CLI?▼

Yes, managing sandbox, network, and attribution settings requires manually updating the ~/.cursor/cli-config.json file. You must input standard JSON that adheres to Cursor's documented option schema to safely tune these specific CLI behaviors.

Related Skills

Explore More Software Engineering Skills→
brujackbrujack
5

update-cli-config

View and modify Cursor CLI settings in ~/.cursor/cli-config.json.

Community
Intermediate
LAF-USLAF-US

update-cli-config

Update Cursor CLI preferences by merging home and project config overrides.

Official
Intermediate
PandelisZPandelisZ
1

update-cli-config

View and update Cursor CLI settings in ~/.cursor/cli-config.json.

Community
Intermediate
geoffjaygeoffjay
8

cli-configuration

Manage CLI application configuration with layered precedence and XDG directories.

Community
Advanced