The latest articles on DEV Community by NtoX (@ntooxx). https://dev.to/ntooxx https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3991134%2F861fe694-e67b-4da2-95af-9f6fb89f0437.png https://dev.to/ntooxx en NtoX Thu, 18 Jun 2026 15:00:15 +0000 https://dev.to/ntooxx/how-i-built-a-local-tool-that-maps-any-codebase-in-55-seconds-no-cloud-no-uploads-48na https://dev.to/ntooxx/how-i-built-a-local-tool-that-maps-any-codebase-in-55-seconds-no-cloud-no-uploads-48na <p>I spend a lot of time working with AI coding agents Claude Code, Cline, Cursor, OpenCode. And every time I start a new task in a large repo, I hit the same wall: the agent has no idea what the codebase looks like.</p> <p>So I built Sentinel.</p> <h2> What it does </h2> <p>Point it at any repo. It scans everything locally (no uploads, no API keys, no internet needed) and produces:</p> <ul> <li>🏗️ Architecture map — components, dependencies, patterns</li> <li>💊 Health score — maintainability, complexity, test coverage</li> <li>🔥 Risk hotspots — oversized files, TODO density, doc drift</li> <li>🎯 Entry points — what the AI should focus on first</li> <li>🤖 Agent prompt — ready-to-paste into Claude Code / Cline / Cursor</li> <li>📄 HTML report — self-contained, zero external assets</li> </ul> <h2> Why local-only matters </h2> <p>Every scan runs entirely on your machine. No code leaves your disk. No API calls. Pure Python stdlib — zero external dependencies. </p> <p>The AI agent prompt it generates a total of (~2,500 tokens) replaces hours of manually reading files and explaining the codebase to your agent.</p> <h2> Get it </h2> <div class="highlight js-code-highlight"> <pre class="highlight plaintext"><code> bash pip install git+https://github.com/Ntooxx/Sentinel.git project-sentinel scan . --fast 🔗 GitHub: https://github.com/Ntooxx/Sentinel 🌐 Dashboard demo: sentinel-nt.netlify.app 📦 197 tests, 0 failures Let me know what breaks or what's missing. I'm actively improving it. </code></pre> </div> opensource python ai programming