Matrix Doctor

What problem does it solve?

Matrix Doctor identifies and resolves failures in the Claude Matrix plugin by running end-to-end health checks and applying safe automatic repairs so the plugin returns to a usable state.

Core Features & Use Cases

• Directory and Permissions Check: Verifies the Matrix directory exists at ~/.claude/matrix and is writable, creating it when missing.
• Database and Schema Validation: Tests database connectivity, validates schema version, and reinitializes the database if required.
• Configuration and Hooks Validation: Detects invalid or missing configuration sections and broken hooks, resetting to defaults or reinstalling hooks.
• Code Index and Repo Detection: Confirms repository indexing and fingerprinting, triggers reindexing when necessary.
• Use Case: When Matrix fails to index a repository or reports database errors, run Matrix Doctor to automatically diagnose the root cause, fix common problems, and generate a GitHub issue template if manual intervention is required.

Quick Start

Run the Matrix Doctor to diagnose and automatically repair the Matrix plugin on the current machine with automatic fixes enabled.