Quick Start
Open the GUI
Section titled “Open the GUI”sentrux # scan current directorysentrux /path/to/project # scan a specific projectYou’ll see a live treemap of your codebase — every file sized by lines of code, colored by language or quality. Dependency edges overlay the map.
Check quality in CI
Section titled “Check quality in CI”sentrux check .# ✓ All rules pass — Quality: 7342Exit code 0 = pass, 1 = fail. Add to your CI pipeline.
Quality gate (before/after agent session)
Section titled “Quality gate (before/after agent session)”# Before the agent startssentrux gate --save .
# ... agent writes code ...
# After the agent finishessentrux gate .# ✗ Quality degraded: 7342 → 6891The score
Section titled “The score”sentrux computes one number: Quality Signal (0–10,000).
It’s the geometric mean of 5 root cause metrics:
| Metric | What it measures |
|---|---|
| Modularity | Do files cluster into independent modules? (Newman’s Q) |
| Acyclicity | Are there circular dependencies? (Tarjan’s SCC) |
| Depth | How deep are dependency chains? |
| Equality | Is complexity evenly distributed? (Gini coefficient) |
| Redundancy | How much dead/duplicate code exists? |
Every +1 point is real architectural improvement. No letter grades, no arbitrary boundaries.