Why Matrix?

Claude Code is exceptional at coding. Matrix makes it exceptional at everything else—remembering what worked, navigating codebases, catching bad dependencies, and turning insights into reusable skills.

Install

/plugin marketplace add ojowwalker77/Claude-Matrix
/plugin install matrix@ojowwalker77-Claude-Matrix

Requires Bun v1.0+ and Claude Code v2.0+

Verify with /matrix:doctor

Platform: macOS and Linux only. Windows users should use WSL or fork the repo and adjust paths manually.

What's New in v2.0

v2.0.2

• Subagent Hooks — SubagentStart injects Matrix guidance to Explore/Plan agents
• Wildcard Warnings — Glob patterns in warning rules (src/legacy/**)
• Hook Timeouts — Configurable timeout (default 30s, max 120s)
• Index Tools Anywhere — Query any indexed repo via repoPath parameter
• Token Optimization — ~10-12% reduction in MCP tool definitions

v2.0.0

• Hook Verbosity — compact mode cuts token overhead by 80%
• Unified Warn API — Single matrix_warn tool with action parameter
• Skill Factory — Promote high-value solutions to Claude Code Skills
• Blast Radius — matrix_find_callers shows impact before changes
• Code Review — 5-phase review pipeline via /matrix:review
• Deep Research — Multi-source aggregation via /matrix:deep-research
• User Rules — Custom pattern matching (block, warn, allow)

Breaking Changes (v2.0)

• Removed: /matrix:verify, /matrix:stats, /matrix:search
• Changed: Four warn tools → single matrix_warn

See CHANGELOG.md for details.

Features

Memory System

Solutions persist across sessions with semantic search:

You solve a problem → Matrix stores it with embeddings
                            ↓
       Similar problem later → Matrix recalls the solution
                            ↓
            Feedback → Rankings improve over time

Code Index

Fast navigation across 15 languages—auto-indexed on session start.

Languages: TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, Swift, C#, Ruby, PHP, C, C++, Elixir, Zig

Warnings

Track problematic files and packages with a unified API:

matrix_warn({ action: 'check', type: 'file', target: 'src/legacy.ts' })
matrix_warn({ action: 'add', type: 'package', target: 'moment', reason: 'Use date-fns' })
matrix_warn({ action: 'remove', id: 'warn_abc123' })
matrix_warn({ action: 'list' })

Skill Factory

Identify and promote high-value solutions to Claude Code Skills:

External Context

Diagnostics

Automatic Hooks

Matrix runs in the background without explicit invocation:

Commands

Configuration

Matrix creates ~/.claude/matrix/matrix.config on first run:

{
  "indexing": {
    "enabled": true,
    "excludePatterns": [],
    "maxFileSize": 1048576,
    "includeTests": false
  },
  "hooks": {
    "enabled": true,
    "verbosity": "compact",
    "permissions": {
      "autoApproveReadOnly": true,
      "autoApprove": {
        "coreRead": true,
        "web": true,
        "matrixRead": true,
        "context7": true
      }
    },
    "userRules": {
      "enabled": true,
      "rules": []
    }
  }
}

Verbosity Levels

User Rules

Add custom patterns to hooks.userRules.rules[]:

{
  "name": "block-rm-rf",
  "event": "bash",
  "pattern": "rm\\s+-rf\\s+/",
  "action": "block",
  "message": "Dangerous command blocked"
}

See User Rules Templates for 30+ ready-to-use rules.

Performance

MCP Annotations

All 18 tools include official MCP hints:

Haiku Delegation

12 tools delegable to Haiku sub-agents for cost optimization:

matrix_recall, matrix_reward, matrix_status, matrix_warn
matrix_find_definition, matrix_find_callers, matrix_search_symbols
matrix_list_exports, matrix_get_imports, matrix_index_status
matrix_reindex, matrix_skill_candidates

Example: Haiku sub-agent executing matrix_recall

Data Storage

~/.claude/matrix/
├── matrix.db              # SQLite database
├── matrix.config          # Configuration
├── models/                # Embedding model (~23MB)
├── grammars/              # Tree-sitter parsers (on-demand)
└── session-analysis.jsonl # Session logs

All data local. No external API calls for memory.

Update

Navigate to /plugin → Marketplaces → Update marketplace

Screenshot

Note: Claude Code updates have known quirks. May require restart or multiple attempts.