# sentrux/sentrux

Real-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.

Repository: https://github.com/sentrux/sentrux
Canonical: https://ross.abutalabs.com/products/sentrux
Homepage: https://sentrux.dev
Language: Rust
License: MIT
License Family: permissive
Topics: architecture, code-quality, developer-tools, mcp, rust, static-analysis, treemap, visualization, harnessengineering, cobol, cobol-language, agentharness
Last push: 2026-03-19T02:23:12+00:00

## Health v2 (maintenance only)
Score: 61/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 72, release rhythm 75, longevity 12
- inputs: {"age_days": 175, "days_push": 168, "days_rel": 168, "gap_med": 0.0, "n_releases_24m": 37}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2911, forks 270 (observed 2026-08-28T04:07:29.173892+00:00)

## What it is
Sentrux is a pure-Rust static analysis tool that computes a single architectural quality score (0–10,000) from five graph-theoretic root-cause metrics and visualizes codebases as a live treemap. It runs as a CLI, a GUI, and an MCP server so AI coding agents can measure and iteratively improve code quality.

## Use cases
- measure architectural health of my codebase with one score
- detect circular dependencies and god files
- give my AI coding agent feedback on code quality via MCP
- set a quality gate in CI to catch degradation
- visualize project structure as a treemap
- find untested code paths and git hotspots

## When to choose
- you use AI coding agents (Claude Code, Cursor) and want to prevent architectural decay
- you want a single ungameable quality metric for CI gates
- you need fast, dependency-free static analysis across 52 languages

## When to avoid
- you need deep linting or style enforcement rather than structural metrics
- you require Pro features like diagnostics or what-if analysis without paying
- your project is not file/dependency-graph based

## Facets
- artifact type: cli-tool
- maturity: active
- function: linter, data-visualization, mcp, developer-tools
- domain: developer-tools, programming-languages
- platform: windows, cli, rust
- tags: code-quality, architecture-analysis, treemap, quality-gate, ai-agents, tree-sitter, static-analysis, automation, macos, linux

## Member repositories
- sentrux/sentrux (main) score 61

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:29.173892+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:48:13.067349+00:00, confidence not recorded.
  - readme: https://github.com/sentrux/sentrux (fetched 2026-08-28T04:07:29.173892+00:00, sha 48d3c6715842)
  - homepage: https://sentrux.dev (fetched 2026-08-29T09:49:33.495585+00:00, sha 5ca86e63de15)
  - site_page: https://sentrux.dev/docs/quality-signal (fetched 2026-08-29T09:49:33.505227+00:00, sha a6a553438492)
  - site_page: https://sentrux.dev/docs/pro (fetched 2026-08-29T09:49:33.507359+00:00, sha 5e1161adfa65)
  - site_page: https://sentrux.dev/docs/mcp (fetched 2026-08-29T09:49:33.508945+00:00, sha 480407069b46)
- Data as of 2026-08-30T08:39:29.467469+00:00.