Claude on Rails Tooling System
$git clone https://github.com/ojowwalker77/claude-matrixInstalls into the current project.
Install claude-matrix by running `git clone https://github.com/ojowwalker77/claude-matrix`, then use it for the current task and follow its documentation at https://github.com/ojowwalker77/claude-matrix.
| 1 | <div align="center"> |
| 2 | |
| 3 | |
| 4 | <img width="1107" height="861" alt="Screenshot 2026-01-19 at 10 53 42" src="https://github.com/user-attachments/assets/8226a695-0fda-44ff-b4e1-16d5ab2fd28c" /> |
| 5 | |
| 6 | |
| 7 | [](CHANGELOG.md) |
| 8 | [](LICENSE) |
| 9 | |
| 10 | <sub>Community plugin for Claude Code. Not affiliated with Anthropic.</sub> |
| 11 | |
| 12 | If Matrix saved you time, be kind and leave a star. |
| 13 | |
| 14 | </div> |
| 15 | |
| 16 | --- |
| 17 | |
| 18 | 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. |
| 19 | |
| 20 | ``` |
| 21 | /plugin marketplace add ojowwalker77/Claude-Matrix |
| 22 | /plugin install matrix@ojowwalker77-Claude-Matrix |
| 23 | ``` |
| 24 | |
| 25 | Requires [Bun](https://bun.sh) v1.0+ and Claude Code v2.0+. Verify with `/matrix:doctor`. |
| 26 | |
| 27 | > **macOS and Linux only.** Windows users need [WSL](https://learn.microsoft.com/en-us/windows/wsl/install). |
| 28 | |
| 29 | ## What You Get |
| 30 | |
| 31 | | Feature | What It Does | |
| 32 | |---------|--------------| |
| 33 | | **Memory** | Solutions persist. Claude recalls what worked before. | |
| 34 | | **Code Index** | Find definitions, callers, exports instantly (15 languages) | |
| 35 | | **Hooks** | Auto-approve reads, catch bad packages, warn on sensitive files | |
| 36 | | **Warnings** | Track problematic files and packages with CVE checks | |
| 37 | | **Code Review** | 5-phase analysis with blast radius and impact mapping | |
| 38 | | **Deep Research** | Multi-source research aggregation | |
| 39 | | **Nuke** | Dead code, orphaned files, circular dependencies, stale TODOs | |
| 40 | | **Context7** | Always-current library documentation | |
| 41 | |
| 42 | --- |
| 43 | |
| 44 | ## Memory |
| 45 | |
| 46 | Solutions persist across sessions with semantic search: |
| 47 | |
| 48 | ``` |
| 49 | You solve a problem -> Matrix stores it |
| 50 | Similar problem later -> Matrix recalls it |
| 51 | Feedback -> Rankings improve |
| 52 | ``` |
| 53 | |
| 54 | **Tools:** `matrix_recall` `matrix_store` `matrix_reward` `matrix_failure` `matrix_status` |
| 55 | |
| 56 | --- |
| 57 | |
| 58 | ## Code Index |
| 59 | |
| 60 | Fast symbol navigation powered by tree-sitter. Auto-indexed on session start. Respects `.gitignore`. Uses content hashing for reliable incremental updates. |
| 61 | |
| 62 | **Languages:** TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, Swift, C#, Ruby, PHP, C, C++, Elixir, Zig |
| 63 | |
| 64 | **Tools:** `matrix_find_definition` `matrix_find_callers` `matrix_search_symbols` `matrix_list_exports` `matrix_get_imports` `matrix_find_dead_code` `matrix_find_circular_deps` |
| 65 | |
| 66 | --- |
| 67 | |
| 68 | ## Hooks |
| 69 | |
| 70 | Matrix runs automatically in the background: |
| 71 | |
| 72 | | Trigger | Action | |
| 73 | |---------|--------| |
| 74 | | Session starts | Index code, initialize memory | |
| 75 | | Tool permission requested | Auto-approve read-only tools | |
| 76 | | Before `npm install` | Check CVEs, deprecation, bundle size | |
| 77 | | Before reading file | Warn if sensitive (.env, keys, secrets) | |
| 78 | | Before editing file | Warn if file has known issues | |
| 79 | |
| 80 | --- |
| 81 | |
| 82 | ## Commands |
| 83 | |
| 84 | | Command | Purpose | |
| 85 | |---------|---------| |
| 86 | | `/matrix:review` | 5-phase code review with impact analysis | |
| 87 | | `/matrix:deep-research` | Multi-source research aggregation | |
| 88 | | `/matrix:nuke` | Codebase hygiene analysis | |
| 89 | | `/matrix:doctor` | Diagnostics and auto-fix | |
| 90 | | `/matrix:list` | View solutions, stats, warnings | |
| 91 | | `/matrix:warn` | Manage file/package warnings | |
| 92 | | `/matrix:reindex` | Rebuild code index | |
| 93 | |
| 94 | --- |
| 95 | |
| 96 | ## Configuration |
| 97 | |
| 98 | Config at `~/.claude/matrix/matrix.config`: |
| 99 | |
| 100 | ```json |
| 101 | { |
| 102 | "hooks": { |
| 103 | "verbosity": "compact", |
| 104 | "permissions": { "autoApproveReadOnly": true } |
| 105 | }, |
| 106 | "delegation": { "enabled": true, "model": "haiku" } |
| 107 | } |
| 108 | ``` |
| 109 | |
| 110 | **Verbosity:** `full` (~500 tokens) or `compact` (~80, recommended) |
| 111 | |
| 112 | **Model Delegation:** Routes simple ops to Haiku for ~40-50% cost savings. |
| 113 | |
| 114 | --- |
| 115 | |
| 116 | ## Data |
| 117 | |
| 118 | ``` |
| 119 | ~/.claude/matrix/ |
| 120 | ├── matrix.db # SQLite database |
| 121 | ├── matrix.config # Configuration |
| 122 | ├── models/ # Embedding model (~23MB) |
| 123 | └── grammars/ # Tree-sitter parsers |
| 124 | ``` |
| 125 | |
| 126 | All data local. No external API calls for memory. |
| 127 | |
| 128 | --- |
| 129 | |
| 130 | ## Links |
| 131 | |
| 132 | [Changelog](CHANGELOG.md) [LLM Reference](docs/reference-for-llms.md) |
| 133 | |
| 134 | <div align="center"> |
| 135 | <sub>MIT License</sub> |
| 136 | </div> |