I built projscan - a CLI that gives you instant codebase insights for any repo

Abhi — Wed, 11 Mar 2026 22:19:01 +0000

Every time I clone a new repo, join a new team, or revisit an old project, I waste 10-30 minutes figuring out: What language? What framework? Is there linting? Testing? What's the project structure? Are the dependencies healthy?

So I built projscan - a single command that answers all of that in under 2 seconds.

What it does:

Detects languages, frameworks, and package managers
Scores project health (A-F grade)
Finds security issues (exposed secrets, vulnerable patterns)
Shows directory structure and language breakdown
Auto-fixes common issues (missing .editorconfig, prettier, etc.)
CI gate mode - fail builds if health drops below a threshold
Baseline diffing - track health over time

Quick start:
npm install -g projscan projscan

Other commands (but there are more, you can run --help to see all of them):
projscan doctor # Health check projscan fix # Auto-fix issues projscan ci # CI health gate projscan explain src/app.ts # Explain a file projscan diagram # Architecture map

It's open source (MIT): github.com/abhiyoheswaran1/projscan
npm: npmjs.com/package/projscan

Would love feedback. What features would make this more useful for your workflow?

DEV Community: Abhi

I built projscan - a CLI that gives you instant codebase insights for any repo