Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,44 @@

All notable changes to Claude Matrix are documented here.

## [2.4.0] - 2026-04-01

> Leaner, sharper. Claude Code grew up, so we dropped what it handles natively and doubled down on what only Matrix can do.

### Removed
- **Dreamer (Scheduled Tasks)** - Removed the entire cron/scheduler system (`src/dreamer/`, `croner`, `cronstrue` packages). Claude Code now has native scheduling via `CronCreate`/`RemoteTrigger`.
- **Background Jobs** - Removed async job system (`src/jobs/`). Reindex now runs synchronously. `matrix_job_status`, `matrix_job_cancel`, `matrix_job_list` tools removed.
- **Prompt Tool** (`matrix_prompt`) - Removed prompt analysis tool. High token cost, marginal value.
- **PromptAnalysis Hook** - Removed memory injection into prompts. Token overhead outweighed benefit.
- **SubagentStart Hook** - Removed hint injection into subagents.
- **PostToolUse:Bash Hook** - Removed bash output logging. Claude sees output directly.
- **TaskCompleted Hook** - Removed task completion logging.
- **Clone Repo Skill** (`/matrix:clone-repo`) - `git clone` works fine natively.
- **RunMD Skill** (`/matrix:runmd`) - Bash tool covers this.
- **`@anthropic-ai/sdk`** dependency - Was unused (never imported).

### Changed
- **DB Migrations Flattened** - Replaced 8 incremental migrations + 100 LOC version detection with a single idempotent legacy upgrade. `SCHEMA_VERSION` bumped to 9. Existing DBs at any version (1-8) upgrade cleanly.
- **Dependencies Updated**
- `@modelcontextprotocol/sdk` 1.25.0 → 1.29.0
- `@sinclair/typebox` 0.34.45 → 0.34.49
- `web-tree-sitter` 0.26.3 → 0.26.8
- `@types/bun` 1.3.4 → 1.3.11
- `oxlint` 1.35.0 → 1.58.0

### Improved
- **Scanner: .gitignore support** - File scanner now parses `.gitignore` and respects all patterns. No more indexing build output or generated files.
- **Scanner: symlink cycle detection** - Detects and skips symlink cycles and broken symlinks via `lstat()`.
- **Incremental indexing: content hash** - Uses SHA-256 content hashing (stored in DB) instead of mtime-only detection. Catches refactors where timestamp is unreliable, skips `touch`-without-edit.
- **Parser: per-file timeout** - 10s timeout per file prevents hangs on malformed/huge files.
- **Python parser: decorator extraction** - Captures `@property`, `@staticmethod`, `@classmethod`, `@dataclass` and custom decorators. Properties correctly classified. Dataclass fields auto-extracted.
- **TypeScript parser: re-export tracking** - `export { X } from './bar'`, `export * from './bar'` now create import edges. Fixes caller detection through barrel exports.
- **Symbol search: fuzzy ranking** - `searchSymbols` now ranks exact > prefix > substring, with optional kind filter and higher default limit (30).
- **Import resolution: tsconfig path aliases** - Loads `tsconfig.json`/`jsconfig.json` `compilerOptions.paths` for accurate import graph resolution (e.g., `@/utils/foo` → `src/utils/foo`).
- **Zero lint warnings** - Cleaned all 15 pre-existing unused import warnings.

---

## [2.3.1] - 2026-03-02

### Fixed
Expand Down
68 changes: 22 additions & 46 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,18 @@
<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" />


[![Version](https://img.shields.io/badge/v2.2.2-blue.svg)](CHANGELOG.md)
[![Version](https://img.shields.io/badge/v2.4.0-blue.svg)](CHANGELOG.md)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

<sub>Community plugin for Claude Code • Not affiliated with Anthropic</sub>
<sub>Community plugin for Claude Code. Not affiliated with Anthropic.</sub>

If Matrix saved you time, be kind and leave a star.

</div>

---

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.
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
Expand All @@ -22,20 +24,19 @@ Matrix turns Claude Code into a complete development environment. Memory that pe

Requires [Bun](https://bun.sh) v1.0+ and Claude Code v2.0+. Verify with `/matrix:doctor`.

> **macOS and Linux only.** Windows is not supported. Windows users must use [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) or fork the repo and adapt paths manually.
> **macOS and Linux only.** Windows users need [WSL](https://learn.microsoft.com/en-us/windows/wsl/install).

## 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 |
| **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 aggregation into polished markdown |
| **Nuke** | Codebase hygiene analysis — dead code, orphaned files, stale TODOs |
| **Deep Research** | Multi-source research aggregation |
| **Nuke** | Dead code, orphaned files, circular dependencies, stale TODOs |
| **Context7** | Always-current library documentation |

---
Expand All @@ -45,22 +46,22 @@ Requires [Bun](https://bun.sh) v1.0+ and Claude Code v2.0+. Verify with `/matrix
Solutions persist across sessions with semantic search:

```
You solve a problem Matrix stores it
Similar problem later Matrix recalls it
Feedback Rankings improve
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`
**Tools:** `matrix_recall` `matrix_store` `matrix_reward` `matrix_failure` `matrix_status`

---

## Code Index

Fast symbol navigation. Auto-indexed on session start.
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`
**Tools:** `matrix_find_definition` `matrix_find_callers` `matrix_search_symbols` `matrix_list_exports` `matrix_get_imports` `matrix_find_dead_code` `matrix_find_circular_deps`

---

Expand All @@ -71,34 +72,10 @@ 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 |
| 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`

---

Expand All @@ -108,12 +85,11 @@ Schedule Claude tasks with native OS schedulers (launchd/crontab):
|---------|---------|
| `/matrix:review` | 5-phase code review with impact analysis |
| `/matrix:deep-research` | Multi-source research aggregation |
| `/matrix:doctor` | Diagnostics + auto-fix |
| `/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 |
| `/matrix:nuke` | Codebase hygiene analysis |
| `/matrix:clone-repo` | Clone external repos for exploration |

---

Expand All @@ -131,7 +107,7 @@ Config at `~/.claude/matrix/matrix.config`:
}
```

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

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

Expand All @@ -153,7 +129,7 @@ All data local. No external API calls for memory.

## Links

[Changelog](CHANGELOG.md) · [Roadmap](ROADMAP.md) · [Contributing](CONTRIBUTING.md) · [LLM Reference](docs/reference-for-llms.md)
[Changelog](CHANGELOG.md) [LLM Reference](docs/reference-for-llms.md)

<div align="center">
<sub>MIT License</sub>
Expand Down
Loading
Loading