update-cli-config

Read and update Cursor CLI configuration in ~/.cursor/cli-config.json.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cuongnm-dev/team-ai-config --skill update-cli-config-cuongnm-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-cli-config
Source: https://github.com/cuongnm-dev/team-ai-config/tree/main/cursor/skills-cursor/update-cli-config
Command: npx skills add https://github.com/cuongnm-dev/team-ai-config --skill update-cli-config-cuongnm-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

View and modify the Cursor CLI configuration stored at ~/.cursor/cli-config.json, enabling quick customization of permissions, editor behavior, display options, sandbox settings, and per-project overrides.

Core Features & Use Cases

  • View and edit the main configuration file at ~/.cursor/cli-config.json.
  • Merge per-project overrides found in .cursor/cli.json as you navigate between repo roots and workspaces.
  • Apply changes by restarting the Cursor CLI to activate updates, with guidance on reverting or validating settings.

Quick Start

Load your ~/.cursor/cli-config.json, modify needed settings, and restart Cursor CLI to apply changes.

Frequently Asked Questions about update-cli-config

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

FAQPage Schema
How do I update my Cursor CLI configuration for permissions and sandbox settings?

You can update your Cursor CLI configuration by modifying the ~/.cursor/cli-config.json file to adjust permissions, sandbox settings, and editor behavior. You must restart the Cursor CLI for changes to take effect.

How do I apply per-project configuration overrides in a multi-repo workspace?

Per-project configuration overrides are applied by merging settings from a .cursor/cli.json file located in your repository root. This allows workspace-specific settings to override the main CLI configuration.

What settings can I control in the Cursor CLI config file?

The Cursor CLI config file controls permissions, editor behavior, display options, and sandbox settings. These configurations are stored in the ~/.cursor/cli-config.json file for individual developers or teams.

Why are my Cursor CLI configuration changes not taking effect?

Cursor CLI configuration changes require a restart to take effect. After modifying ~/.cursor/cli-config.json or project overrides in .cursor/cli.json, you must restart the CLI to apply the updated settings.

Can I customize editor behavior like vim-mode in the Cursor CLI?

Yes, you can customize editor behavior including vim-mode by updating your Cursor CLI configuration. Modify the editor behavior settings in your ~/.cursor/cli-config.json file and restart the CLI.

Does the Cursor CLI support configuration for CI environments?

Yes, the Cursor CLI supports configuration across local machines, CI environments, and multi-repo workspaces. You manage these settings by reading and writing to ~/.cursor/cli-config.json.