DevLens

DevLens Codebase comprehension scanner + AI slop detector Installation . Usage . Configuration . Contributing . License What it does Lost in a new codebase? DevLens scans your Python project and scores every file from 0 to 100 based on how hard it is to understand. It uses code complexity metrics, git history signals, and optional AI judgment to pinpoint the files your team will struggle with. It also shows project statistics (languages, lines, directories) and can summarize each file with AI. DevLens also detects AI-generated or low-effort pull requests using pure heuristic signals: no LLM calls, no API costs, fully deterministic. Drop it in CI to catch slop before it merges. Why this is useful Onboarding a new developer? They know which files to ask about first. Planning a sprint? You see which files got worse since the last scan. Reporting to a manager? You show a trend line: "Our codebase went from 45 to 62 this quarter." Quick start Set your API key (for AI features): Run a scan: Commands Command What it does --- --- devlens -scan Full scan with all three layers (needs API key) devlens -scan --no-llm Scan without AI (deterministic, works in CI)