claude-code - 💡(How to fix) Fix plugin marketplace remove rejects --scope flag while sibling commands accept it [1 participants]

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…
GitHub stats
anthropics/claude-code#57802Fetched 2026-05-11 03:25:00
View on GitHub
Comments
0
Participants
1
Timeline
5
Reactions
0
Participants
Timeline (top)
labeled ×5

claude plugin marketplace remove <name> --scope local errors with unknown option '--scope', but every sibling plugin command accepts --scope local cleanly. The flag should either be honored on marketplace remove or — if it's intentionally rejected — the omission should be documented.

Error Message

This works:

claude plugin marketplace add ~/some-plugin-dir --scope local

→ ✔ Successfully added marketplace: <name> (declared in local settings)

This works:

claude plugin install <plugin>@<marketplace> --scope local

→ ✔ Successfully installed plugin: ...

This works:

claude plugin uninstall <plugin>@<marketplace> --scope local

→ ✔ Successfully uninstalled plugin: ...

This FAILS:

claude plugin marketplace remove <marketplace> --scope local

→ error: unknown option '--scope'

Root Cause

claude plugin marketplace remove <name> --scope local errors with unknown option '--scope', but every sibling plugin command accepts --scope local cleanly. The flag should either be honored on marketplace remove or — if it's intentionally rejected — the omission should be documented.

Code Example

# This works:
claude plugin marketplace add ~/some-plugin-dir --scope local
# → ✔ Successfully added marketplace: <name> (declared in local settings)

# This works:
claude plugin install <plugin>@<marketplace> --scope local
# → ✔ Successfully installed plugin: ...

# This works:
claude plugin uninstall <plugin>@<marketplace> --scope local
# → ✔ Successfully uninstalled plugin: ...

# This FAILS:
claude plugin marketplace remove <marketplace> --scope local
# → error: unknown option '--scope'

---

claude plugin marketplace remove <marketplace>
# → ✔ Successfully removed marketplace: ...
RAW_BUFFERClick to expand / collapse

Summary

claude plugin marketplace remove <name> --scope local errors with unknown option '--scope', but every sibling plugin command accepts --scope local cleanly. The flag should either be honored on marketplace remove or — if it's intentionally rejected — the omission should be documented.

Reproduce

Tested on Claude Code 2.1.138, macOS (darwin 25.2.0).

# This works:
claude plugin marketplace add ~/some-plugin-dir --scope local
# → ✔ Successfully added marketplace: <name> (declared in local settings)

# This works:
claude plugin install <plugin>@<marketplace> --scope local
# → ✔ Successfully installed plugin: ...

# This works:
claude plugin uninstall <plugin>@<marketplace> --scope local
# → ✔ Successfully uninstalled plugin: ...

# This FAILS:
claude plugin marketplace remove <marketplace> --scope local
# → error: unknown option '--scope'

Dropping --scope works:

claude plugin marketplace remove <marketplace>
# → ✔ Successfully removed marketplace: ...

Expected behavior

marketplace remove should accept --scope local|user|managed for symmetry with marketplace add, install, and uninstall. Authoring scripts that round-trip a test marketplace (add → install → uninstall → remove) currently have to special-case this one command.

Suggested fix

Either:

  1. Accept --scope on marketplace remove (resolve to the corresponding settings.json the way marketplace add does), OR
  2. Document under Plugin marketplaces that marketplace remove operates on whichever scope the marketplace was declared in, and that the --scope flag is intentionally not exposed.

Option 1 is the lower-friction fix; option 2 leaves a paper trail for anyone hitting the same surprise.

Why I noticed

I shipped a small Claude Code plugin with a marketplace manifest and ran a round-trip verification script (claude plugin marketplace add → install → uninstall → marketplace remove) as part of the install path's test suite. The remove step was the only one that failed.

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…

FAQ

Expected behavior

marketplace remove should accept --scope local|user|managed for symmetry with marketplace add, install, and uninstall. Authoring scripts that round-trip a test marketplace (add → install → uninstall → remove) currently have to special-case this one command.

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 plugin marketplace remove rejects --scope flag while sibling commands accept it [1 participants]