PatchMind is a modular Python CLI tool for Git repositories that generates smart, visual HTML reports.
It captures patch-level diffs, tree views, file history timelines, risk scoring, and more — all locally.
No cloud. No bloat. Just clean insight.
- 🔍 Detects file-level and line-level changes across commits
- 🌳 Tree-based visualization of modified paths
- 📅 File timeline view with authorship and metadata
⚠️ Risk and impact scoring per file- 👤 Inline blame summaries
- 📄 Clean, standalone HTML output
- ⚙️ Fully CLI-driven — automate in CI/CD
Install from PyPI:
pip install patchmind
Or install manually:
git clone https://github.com/Darkstar420/patchmind.git
cd patchmind
pip install -r requirements.txt
Generate an HTML report from the root of any Git repo:
python cli/main.py --report
The output will be saved as patchmind_report.html
in the project root.
patchmind/
├── cli/ # CLI entrypoint
├── core/ # Core analysis engine
├── tests/ # Unit tests
├── docs/ # Sample reports and images
├── config.yaml # Config (optional)
├── requirements.txt
└── README.md
pytest -q
Unit tests live in tests/
and validate key functionality, including mock Git data and report rendering.
✅ No setup required – run it instantly ✅ See what's changing, where, and why ✅ Stay ahead of technical debt ✅ Built for devs who want insight — not overhead
Licensed under the Apache 2.0 License — free to use, modify, and distribute.