One command. Full picture. Actionable.

X-Ray Your Codebase.

One command surfaces risky files, knowledge silos, and hidden dependencies from your Git history. No API tokens. No config. Any repo.

$ npx git-vision
GitHub
Click to copy · Works in any Git repo
~/my-project
Analysis

What It Finds

Your Git history tells a story. git-vision reads between the lines.

⚠️

Hotspot Detection

Files with high churn AND complexity are where bugs cluster. Formula: risk = churn × LOC. Test files are automatically dampened. We find the riskiest files before they find you.

👥

Bus Factor

One person owns 90% of a critical file? That's a bus-factor-1 risk. We flag every knowledge silo in your codebase.

src/payments.ts BUS FACTOR: 1 alice 92% ████████░░ bob 5% █░░░░░░░░░ carol 3% ░░░░░░░░░░
🔗

Change Coupling

Files that always change together reveal hidden dependencies your import graph doesn't show. Cross-module coupling = architecture smell.

⏰

Code Age

Ancient untouched code and sudden change spikes. Both are signals worth investigating. Categories from volatile to ancient.

📈

Trend Tracking

Compare time periods. See if your codebase is getting healthier or rotting. Detects new hotspots, resolved ones, and worsening files.

👁️

True Ownership (git blame)

Goes beyond commit counting to line-level ownership. A developer who rewrote a file once owns more than someone who made 10 typo fixes. Shows who actually wrote the code that exists today. Enable with --blame.

⚖️

PR Risk Scoring

Run git-vision diff main to score any branch. Exit code 1 on critical risk — perfect for CI gates.

🏗️

Monorepo Support

Auto-detects workspaces from package.json, pnpm, or lerna. Per-workspace health scores so no package is left behind.

Scoring

Repository Health Score

A composite 0-100 score from all analyzers. One number to rule your codebase.

0
Grade B — Good
Hotspots
82
Bus Factor
65
Coupling
91
Code Age
70
Team
88
CLI

15 Commands. Zero Config.

Every analysis module is a subcommand. Mix with flags for precise control.

npx git-vision
Full analysis with health score, all modules
git-vision hotspots
Riskiest files by churn × complexity
git-vision bus-factor
Knowledge silo detection
git-vision coupling
Hidden architectural dependencies
git-vision age
Stale zones & volatile files
git-vision contributors
Per-module team patterns
git-vision diff <branch>
PR risk scoring (CI-friendly exit codes)
git-vision blame
True line-level ownership
git-vision trends
Health over time, period comparison
git-vision monorepo
Per-workspace analysis
git-vision branches
Branch graph & lifecycle analysis
git-vision remote <url>
Analyze any remote repo instantly
git-vision knowledge-loss
Departed contributor detection
git-vision init
Auto-detect stack & generate config
--format html
Interactive treemap & SVG branch graph
Workflow

How It Works

1

Run One Command

npx git-vision in any Git repo. No tokens, no config, no signup.

→
2

Analyze Git History

Parses commits, blame data, branch topology. Pure git log — no API needed.

→
3

Get Actionable Insights

Health score, risk files, knowledge silos, trend direction. Terminal, JSON, or interactive HTML.

Your Codebase
Is Talking.

Works with any Git repo. GitHub, GitLab, Bitbucket, self-hosted. No API tokens needed.

npx git-vision View on GitHub