claude-matrix

_{Community plugin for Claude Code • Not affiliated with Anthropic}

Matrix turns Claude Code into a complete development environment. Memory that persists across sessions. Code indexing across 15 languages. Automated hooks that catch issues before they happen. Scheduled tasks that run while you sleep.

/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 is not supported. Windows users must use WSL or fork the repo and adapt paths manually.

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-inject context, catch bad packages, warn on sensitive files
Warnings	Track problematic files/packages with CVE checks
Dreamer	Schedule tasks — daily reviews, weekly audits, automated commits
Code Review	5-phase analysis with blast radius and impact mapping
Deep Research	Multi-source aggregation into polished markdown
Nuke	Codebase hygiene analysis — dead code, orphaned files, 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. Auto-indexed on session start.

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

Hooks

Matrix runs automatically in the background:

Trigger	Action
Session starts	Index code, initialize memory
Before `npm install`	Check CVEs, deprecation, bundle size
Before editing file	Warn if file has known issues
Before `git commit`	Suggest code review
Task completed	Offer to save notable solutions

Dreamer

Schedule Claude tasks with native OS schedulers (launchd/crontab):

/scheduler:schedule-add
> Name: daily-review
> Schedule: every weekday at 9am
> Command: /matrix:review

Use cases: Daily code review · Weekly dependency audit · Nightly test runs · Automated changelog

Git Worktree Mode: Run in isolated branches that auto-commit and push.

Safety:

skipPermissions OFF by default — respects your existing permission rules
No custom daemon — uses native OS schedulers, no elevated privileges
All inputs sanitized via shellEscape()

Skills: /scheduler:schedule-add · schedule-list · schedule-run · schedule-remove · schedule-status · schedule-logs · schedule-history

Commands

Command	Purpose
`/matrix:review`	5-phase code review with impact analysis
`/matrix:deep-research`	Multi-source research aggregation
`/matrix:doctor`	Diagnostics + auto-fix
`/matrix:list`	View solutions, stats, warnings
`/matrix:warn`	Manage file/package warnings
`/matrix:reindex`	Rebuild code index
`/matrix:nuke`	Codebase hygiene analysis
`/matrix:clone-repo`	Clone external repos for exploration

Configuration

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

JSON

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

Verbosity: full (~500 tokens) · 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 · Roadmap · Contributing · LLM Reference

_{MIT License}