sentrux is a Rust-based sensor that visualizes code structure in real-time to help AI agents improve code quality. It provides a live treemap, a 0–10000 quality score, and a rules engine with MCP integration.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Real-time architectural sensor that visualizes the codebase and provides a multi-maceted quality signal to guide AI-driven improvements. Pure Rust, single binary, with plugin-based language support.
How it works
It scans the project structure and dependencies, computes root-cause metrics, and presents a live interactive treemap. It exposes tools for scanning, health checks, session management, rescan, rule checks, evolution, DSM, and test gaps. It integrates with MCP to share the quality signal with agents.
Getting started
Install (macOS · Linux · Windows)
macOS
brew install sentrux/tap/sentrux
Linux
curl -fsSL https://raw.githubusercontent.com/sentrux/sentrux/main/install.sh | sh
Windows — download from Releases, or:
curl -L -o sentrux.exe https://github.com/sentrux/sentrux/releases/latest/download/sentrux-windows-x86_64.exe
Run it
sentrux
sentrux /path/to/project
sentrux check .
sentrux gate --save .
sentrux gate .
Connect to your AI agent (optional)
/plugin marketplace add sentrux/sentrux
/plugin install sentrux
{
"mcpServers": {
"sentrux": {
"command": "sentrux",
"args": ["--mcp"]
}
}
}
From source / upgrade / troubleshooting
# Build from source
git clone https://github.com/sentrux/sentrux.git
cd sentrux && cargo build --release
brew update && brew upgrade sentrux
# or re-run the curl install — it always pulls the latest release
Linux GPU issues
WGPU_BACKEND=vulkan sentrux
WGPU_BACKEND=gl sentrux
Recent releases
- v0.5.7 — WCAG color system, universal resolver, plugin versions (2026-03-18)
- v0.5.6 — UI scale, font upgrade, open source build fix (2026-03-18)
- v0.5.5 — One True Score — No Legacy Baggage (2026-03-17)
- v0.5.4 — Complete Sensor Overhaul (2026-03-17)
- v0.5.3 — Bug fixes on v0.5.2 (2026-03-16)
Traction
Stargazers: 2631 Forks: 237 Open issues: 27
Behind the repo
sponsored by etc. (not present in facts)
Caveats
License: MIT Created: 2026-03-11 Last push: 2026-03-19 Languages: Rust