v0.1.0 — Initial Release

reposcan v0.1.0 — The Codebase Doctor

Scan any GitHub repo or local codebase. Get a full health report with scores, time bombs, and fixes.

npx reposcan https://github.com/your/repo

Features

• 7 static analyzers — naming, complexity, dead code, phantom imports, secrets, duplicates, dependencies
• 4 health scores (0-100) + overall A-F letter grade
• 💣 Time bomb detection — critical issues ranked by severity with fix suggestions
• Beautiful terminal output — ASCII grade art, colored score bars, severity icons
• HTML report (--html) — self-contained dark-mode report, shareable
• Badge generation (--badge) — shields.io badge for your README
• AI-enhanced mode (optional) — deeper semantic analysis via Claude API
• Zero friction — works without API key in static-only mode

What it finds

	Category	Description
👻	Phantom Imports	Packages imported but not in package.json
💀	Dead Code	Exported functions nobody calls
📋	Copy-Paste Drift	Near-duplicate code blocks
🔑	Hardcoded Secrets	API keys, tokens, passwords in source
⚡	High Complexity	Excessive branching, deep nesting
🏷️	Naming Chaos	Mixed conventions in the same file
📦	Dependency Issues	Wildcard versions, missing lock files, CVEs

Install

npx reposcan ./my-project
# or
npm install -g reposcan