doctor

/doctor - Plugin System Diagnostics

Comprehensive health check across all installed claude-forge. Shows what's installed, what's working, and what needs attention.

Complements: /check-maintenance (continuity files) and /continuity-metrics (session state). This command covers the plugin system itself.

Execution Steps

Step 1: Detect Installed Plugins

On CC v2.1.163+ the native listing is the fastest inventory — but treat it as a claim, not a verdict. It renders from installed_plugins.json, so it prints ✔ enabled even when the plugin's files have been deleted. Always pair it with Step 1a.

claude plugin list --enabled || echo "native list unavailable (CC < 2.1.163)"

Fall back to scanning known plugin directories on older CC:

# Check marketplace cache for each plugin
PLUGINS=("ctk" "etk" "dtk" "atk" "ftk")

for PLUGIN in "${PLUGINS[@]}"; do
  # Check marketplace cache
  CACHE_DIR=$(find ~/.claude/plugins/cache -type d -name "$PLUGIN" | head -1)
  if [ -n "$CACHE_DIR" ]; then
    VERSION=$(grep -h '"version"' "$CACHE_DIR"/*/.claude-plugin/plugin.json | head -1)
    echo "INSTALLED: $PLUGIN ($VERSION)"
  else
    echo "NOT INSTALLED: $PLUGIN"
  fi
done

This glob matches every version folder ever installed, including stale ones left behind by earlier upgrades — which is why Step 1a is mandatory before trusting the result.

Also check for local dev plugins via --plugin-dir:

# Check if running from monorepo (local dev) — source dirs use the legacy long names
if [ -f "plugins/continuity-toolkit/.claude-plugin/plugin.json" ]; then
  echo "LOCAL DEV MODE: Running from monorepo"
fi

Step 1a: Verify Recorded Install Paths Resolve

The Step 1 glob matches any version folder, including stale ones; installed_plugins.json records one specific installPath per plugin. A DANGLING row means the two disagree.

Why this check exists, how to interpret a DANGLING row, and how to repair it live in the doctor skill's Step 1a (skills/doctor/SKILL.md) — the single source of truth. Read it before interpreting a DANGLING row; do not restate its reasoning here.