cc-plugin-cache-multi-version-not-recorded

A Claude Code plugin cache miss warning appears when multiple version subdirectories exist inside a plugin cache parent directory, causing the cache resolver to skip the directory entirely. This leaves old and current plugin versions side by side, triggering the (not recorded) sentinel.

To fix Claude Code plugin cache refresh loops, compare installed plugin records against cache directory contents to identify obsolete version subdirectories. Delete only the stale version directories while preserving the correct version recorded in installed plugin metadata to resolve the mismatch.

The safest way to remove obsolete plugin cache version directories is to compare installed plugin metadata records against cache directory contents first. Delete only the outdated version subdirectories while preserving the correct version directory recorded in your installed plugin metadata.

Reinstalling a Claude Code plugin does not clear the multi-version cache directory mismatch. The underlying cache-state mismatch persists after refresh attempts and reinstalls because stale marketplace SHA updates leave old and current plugin versions side by side, requiring manual obsolete directory removal.

To validate a Claude Code plugin cache parent contains exactly one version directory, inspect the directory contents after removing stale subdirectories. Confirm only the correct version recorded in installed plugin metadata remains and verify the startup cache miss warning no longer appears.