[DOCS] Plugin management docs omit `plugin prune` and `plugin uninstall --prune`

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/plugins-reference

Section/Topic

plugin uninstall in the CLI plugin management reference, plus the missing plugin prune command documentation

Current Documentation

The command reference currently says:

### plugin uninstall Remove an installed plugin. claude plugin uninstall <plugin> [options] Options: | -s, --scope <scope> | Uninstall from scope: user, project, or local | | --keep-data | Preserve the plugin's persistent data directory |

The end-user plugin guide currently says:

Completely remove a plugin: /plugin uninstall plugin-name@marketplace-name

The dependency guide documents automatic dependency installation, but not cleanup:

When you install a plugin that declares dependencies, the install output lists which dependencies were auto-installed alongside it.

No documentation currently exists for claude plugin prune.

What's Wrong or Missing?

Changelog v2.1.121 added claude plugin prune to remove orphaned auto-installed plugin dependencies and added cascading cleanup via claude plugin uninstall --prune.

The current docs are behind that behavior in two places:

A. Missing new command

There is no documented plugin prune command in the plugin command reference or user-facing plugin management guide.

B. Outdated uninstall options

The plugin uninstall reference still lists only --scope and --keep-data, so it does not tell users that uninstall can now cascade dependency cleanup with --prune.

C. Missing cleanup guidance for auto-installed dependencies

The docs explain that dependencies can be auto-installed, but they do not explain how users should remove orphaned auto-installed dependencies after uninstalling a plugin.

Suggested Improvement

Update the plugin management docs to cover the new cleanup workflow introduced in v2.1.121:

1. Add a ### plugin prune subsection to the CLI reference with syntax, a short description, and at least one example:

claude plugin prune

1. Add --prune to the plugin uninstall options table and include an example such as:

claude plugin uninstall formatter@your-org --prune

1. In the user-facing plugin installation/management docs, add a short explanation of when to use plugin prune versus plugin uninstall --prune, and define what counts as an orphaned auto-installed dependency.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/plugins-reference | Primary CLI command reference; lists plugin uninstall options but has no plugin prune section |
| https://code.claude.com/docs/en/discover-plugins | User-facing plugin management guide; shows uninstall commands but not pruning orphaned auto-installed dependencies |
| https://code.claude.com/docs/en/plugin-dependencies | Explains auto-installed plugin dependencies but not how to clean up orphaned ones |

Total scope: 3 pages affected

Source: Changelog v2.1.121

Exact changelog entry:

Added claude plugin prune to remove orphaned auto-installed plugin dependencies; plugin uninstall --prune cascades