[DOCS] Plugin marketplace remove docs missing `--scope user|project|local`

Open 💬 1 comment Opened May 27, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/plugin-marketplaces

Section/Topic

Plugin marketplace remove command reference

Current Documentation

The docs currently say:

### Plugin marketplace remove Remove a configured marketplace. The alias rm is also accepted. ``bash claude plugin marketplace remove <name> ` **Arguments:** * <name>: marketplace name to remove, as shown by claude plugin marketplace list. This is the name from marketplace.json, not the source you passed to add`

Nearby command docs on the same page already document scope support for marketplace add:

| --scope <scope> | Where to declare the marketplace: user, project, or local. See Plugin installation scopes | user |

The v2.1.152 changelog also says:

claude plugin marketplace remove now accepts --scope user|project|local for symmetry with marketplace add, install, and uninstall

What's Wrong or Missing?

The Plugin marketplace remove section does not mention that the command now accepts --scope user|project|local in v2.1.152.

Because the page already documents scope-aware marketplace add behavior, omitting the same flag from remove leaves the command reference incomplete and makes scoped removal harder to discover.

Suggested Improvement

Add an Options table for claude plugin marketplace remove documenting --scope <scope> with the same allowed values used elsewhere (user, project, local).

Update the command examples to include at least one scoped removal example, for example:

claude plugin marketplace remove acme-corp --scope project

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/plugin-marketplaces | 908-918 | Plugin marketplace remove section shows the command and argument but no --scope option |
| https://code.claude.com/docs/en/discover-plugins | 365-368 | Marketplace removal example shows /plugin marketplace remove marketplace-name with no mention of scoped removal |

Cross-references:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/plugin-marketplaces | Plugin marketplace add already documents --scope user|project|local |
| https://code.claude.com/docs/en/plugins-reference | plugin install and plugin uninstall already document --scope values |
| https://code.claude.com/docs/en/changelog | v2.1.152 changelog states that claude plugin marketplace remove now accepts --scope user|project|local |

Total scope: 2 pages affected

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗