| name | redsub-doctor |
| description | Diagnose and auto-repair plugin integrity. |
Doctor
Diagnose plugin health and auto-repair issues.
Checks
1. Legacy rules cleanup
Check for orphaned rules files from previous versions in ~/.claude/rules/:
ls ~/.claude/rules/redsub-*.md 2>/dev/null
If any redsub-*.md files are found, they are leftovers from v2.x (v3.0 no longer deploys rules files).
Auto-fix: Remove orphaned files:
rm -f ~/.claude/rules/redsub-*.md
2. Manifest consistency
Read ~/.claude-redsub/install-manifest.json:
- Verify all
files_created are tracked
- Verify version matches plugin version
Auto-fix: Regenerate manifest from current state.
3. Dependency plugins
Read the plugin registry from ${CLAUDE_PLUGIN_ROOT}/config/plugins.json — this is the Single Source of Truth (SSOT). Do NOT use a hardcoded list.
For each plugin in the registry, check ~/.claude/plugins/installed_plugins.json:
- A plugin is missing if its key (
<name>@<marketplace>) does not exist
- A plugin is not installed if its key exists but
gitCommitSha is empty — register-plugins.sh creates placeholder entries that Claude Code auto-resolves (installPath/version get filled from marketplace cache), but without gitCommitSha they are NOT recognized as installed in Installed tab