v0.9 · Open Source · Zero Deps · 197 Tests

Sentinel

Maps architecture, risk, and runtime surfaces — from 73-file libraries to 25,432-file infrastructure repos in under a minute. Entirely offline, zero dependencies, 100% open source. AI-ready context packs, not vague summaries.

★ Star on GitHub See Benchmarks ↓
73→ 40k files
0.16s→55sscan range
6Mlines scanned
197tests · 0 fails
Scroll
Capabilities

What Sentinel Produces

Seven structured outputs from a single scan — no cloud, no uploads, no dependencies beyond Python stdlib.

Architecture Graph

Live directed graph of your codebase — entry points, module boundaries, dependency flows, resolved through a 5-tier ranked fallback.

Health Score

Maintainability, runtime complexity, test signal, security — with a detailed breakdown so you know exactly where the pain is.

Hotspot Detection

Identifies files with highest risk — oversize files, TODO density, doc drift, test gaps. Ranked by severity so you attack the worst first.

Context Pack

Compact ~2,500 token brief that replaces hours of file reading — ready for Cline, Claude Code, Codex, Roo, Continue. Copy, paste, ship.

Benchmark

Real Performance

Measured across four real-world repositories spanning three orders of magnitude — from 73 to ~40,000 files. Honest numbers, no cherry-picking.

RequestsPython
97%
Files
73
Lines
14,492
Scan
0.16s
Health
86%
97%
Result: Perfect detection. All 73 files, 9 entry points, and 14K lines mapped in 0.16 seconds. Zero false positives. Strongest signal-to-noise ratio.
FastAPIPython
82%
Files
2,736
Lines
356,919
Scan
4.56s
Health
74%
82%
Result: Correctly identified "FastAPI" (not "Sponsors") via 5-tier fallback. Architecture graph clean. Minor internal module naming edge case.
KubernetesGo
74%
Files
25,432
Lines
6,007,991
Scan
55.44s
Health
74%
74%
Result: 6M lines of Go in 55 seconds. Flagged 3 oversize files exceeding 5K lines — kubelet.go recommended for modularization. Top risk correctly identified.
LadybirdC++
75%
Files
~40,000
Lines
~1.4M
Scan
~40s
Health
75%
75%
Result: Largest target — browser engine with 40K files. Classification model correctly handled C++ archetype at scale. Entry-point ranking strong overall.
Approach

Pipeline

Sentinel doesn't summarize. It builds a structured model — identity resolution, architecture graph, runtime awareness, risk scoring, then compresses everything into an AI-ready context pack (~2,500 tokens).

01
Identity

Project Resolution

5-tier ranked fallback — known repo names, manifests, README body, headings — never returns "Sponsors" for FastAPI or garbage for Kubernetes.

02
Graph

Architecture Mapping

Parses imports, modules, and dependencies into a directed graph. Classifies every file by role — runtime, test, build, docs, vendor, generated.

03
Score

Health & Risk Scoring

Computes maintainability, runtime complexity, test signal, and security signals per file. Flags hotspots: oversize files, TODO density, doc drift, test gaps.

04
Pack

Context Compression

Produces a ~2,500 token context pack with ranked next actions — ready for Cline, Claude Code, Codex, Roo, Continue. Copy, paste, understand.

Current State

Known Edges

Transparent about where Sentinel is still evolving. These are honest edges — not hidden flaws.

◆

Project Naming

5-tier fallback resolves most cases (FastAPI → "FastAPI", not "Sponsors") but unconventional manifests can still confuse. Actively tuning tier weights.

◆

Entry Point Ranking

Large monorepos with unconventional layouts may rank secondary entry points below expected thresholds. Go binaries get a +80 bonus — still tuning for edge cases.

◆

Doc Extraction Drift

Sparse or inconsistent docstrings can reduce docs-to-code alignment accuracy. Purpose inference uses 6-step fallback — works on well-documented repos, drifts on sparse ones.

197 tests · 0 failures · 9.3s runtime. Every release tightens the model. If you hit an edge, we want to know — that's how precision climbs.
Open Source
100% Free & Open Source

Apache 2.0 licensed. Zero dependencies. No telemetry, no accounts, no cloud. Built for developers who want AI to understand their codebase — without uploading to the cloud.

Python3.8+ stdlib only
Zeroexternal deps
Apache 2.0free forever
Offlineno telemetry
Get Started
Try Sentinel

Scan your repository in seconds. See what your codebase is actually telling you.

73→ 40k files
0.16s→ 55s scans
6Mlines scanned
197tests · 0 fails