matrix

---

Matrix gives Claude Code persistent memory and deep code intelligence. Solutions survive across sessions. A tree-sitter index makes symbol navigation instant across 15 languages. Hooks catch problems before they happen.

/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.

macOS and Linux only. Windows users need WSL.

What You Get

Feature	What It Does
Memory	Solutions persist. Claude recalls what worked before.
Code Index	Find definitions, callers, exports instantly (15 languages)
Hooks	Auto-approve reads, catch bad packages, warn on sensitive files
Warnings	Track problematic files and packages with CVE checks
Code Review	5-phase analysis with blast radius and impact mapping
Deep Research	Multi-source research aggregation
Nuke	Dead code, orphaned files, circular dependencies, stale TODOs
Context7	Always-current library documentation

---

Memory

Solutions persist across sessions with semantic search:

You solve a problem    ->  Matrix stores it
Similar problem later  ->  Matrix recalls it
Feedback               ->  Rankings improve

Tools: matrix_recall matrix_store matrix_reward matrix_failure matrix_status

---

Code Index

Fast symbol navigation powered by tree-sitter. Auto-indexed on session start. Respects .gitignore. Uses content hashing for reliable incremental updates.

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

Tools: matrix_find_definition matrix_find_callers matrix_search_symbols matrix_list_exports matrix_get_imports matrix_find_dead_code matrix_find_circular_deps

---

Hooks

Matrix runs automatically in the background:

Trigger	Action
Session starts	Index code, initialize memory
Tool permission requested	Auto-approve read-only tools
Before npm install	Check CVEs, deprecation, bundle size
Before reading file	Warn if sensitive (.env, keys, secrets)
Before editing file	Warn if file has known issues

---

Commands

Command	Purpose
/matrix:review	5-phase code review with impact analysis
/matrix:deep-research	Multi-source research aggregation
/matrix:nuke	Codebase hygiene analysis
/matrix:doctor	Diagnostics and auto-fix
/matrix:list	View solutions, stats, warnings
/matrix:warn	Manage file/package warnings
/matrix:reindex	Rebuild code index

---

Configuration

Config at ~/.claude/matrix/matrix.config:

{
  "hooks": {
    "verbosity": "compact",
    "permissions": { "autoApproveReadOnly": true }
  },
  "delegation": { "enabled": true, "model": "haiku" }
}

Verbosity: full (~500 tokens) or compact (~80, recommended)

Model Delegation: Routes simple ops to Haiku for ~40-50% cost savings.

---

Data

~/.claude/matrix/
├── matrix.db       # SQLite database
├── matrix.config   # Configuration
├── models/         # Embedding model (~23MB)
└── grammars/       # Tree-sitter parsers

All data local. No external API calls for memory.

---

Links

Changelog LLM Reference