claude-code - 💡(How to fix) Fix Feature request: pluginDefaultScope setting to control default install scope

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Add a pluginDefaultScope setting to settings.json that controls the default scope when installing plugins via /plugin.

Root Cause

Add a pluginDefaultScope setting to settings.json that controls the default scope when installing plugins via /plugin.

Fix Action

Workaround

Currently none — the field is rejected by schema validation with Unrecognized field: pluginDefaultScope.

Code Example

"pluginDefaultScope": {
  "description": "Default scope for plugin installation: 'user' installs globally, 'project' scopes to the current working directory (default: inferred from context)",
  "type": "string",
  "enum": ["user", "project"]
}

---

// ~/.claude/settings.json
{
  "pluginDefaultScope": "project"
}
RAW_BUFFERClick to expand / collapse

Summary

Add a pluginDefaultScope setting to settings.json that controls the default scope when installing plugins via /plugin.

Motivation

Currently, plugin install scope (user vs project) is inferred from context — user when outside a project root, project when inside one. This works most of the time, but there is no way to explicitly enforce project-scoped installs as a default across all contexts.

A pluginDefaultScope setting would let users (and admins via managed settings) enforce a consistent default without relying on directory context.

Proposed Schema Addition

"pluginDefaultScope": {
  "description": "Default scope for plugin installation: 'user' installs globally, 'project' scopes to the current working directory (default: inferred from context)",
  "type": "string",
  "enum": ["user", "project"]
}

Example Usage

// ~/.claude/settings.json
{
  "pluginDefaultScope": "project"
}

With this set, /plugin install <name> would default to project scope even when the project root detection is ambiguous.

Workaround

Currently none — the field is rejected by schema validation with Unrecognized field: pluginDefaultScope.

Environment

  • Claude Code version: latest (claude-sonnet-4-6)
  • Platform: macOS Darwin 25.4.0

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix Feature request: pluginDefaultScope setting to control default install scope