Skip to content

AI-powered Git patch reporter. PatchMind scans your Git repo and generates clean, standalone HTML reports showing patch-level diffs, file history, tree changes, risk scoring, and blame data. Built for devs who want smarter insight into their codebase — no cloud, no clutter, just local clarity.

License

Notifications You must be signed in to change notification settings

Darkstar420/patchmind

PatchMind Banner

🧠 PatchMind

Run PatchMind Report PyPI - Version License: Apache-2.0 GitHub stars


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.


🚀 Key Features

  • 🔍 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

📸 Sample Output

PatchMind HTML Report Sample


📦 Installation

Install from PyPI:

pip install patchmind

Or install manually:

git clone https://github.com/Darkstar420/patchmind.git
cd patchmind
pip install -r requirements.txt

🧪 Usage

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.


📂 Project Layout

patchmind/
├── cli/               # CLI entrypoint
├── core/              # Core analysis engine
├── tests/             # Unit tests
├── docs/              # Sample reports and images
├── config.yaml        # Config (optional)
├── requirements.txt
└── README.md

🧪 Run Tests

pytest -q

Unit tests live in tests/ and validate key functionality, including mock Git data and report rendering.


💡 Why Use PatchMind?

✅ 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


📄 License

Licensed under the Apache 2.0 License — free to use, modify, and distribute.


About

AI-powered Git patch reporter. PatchMind scans your Git repo and generates clean, standalone HTML reports showing patch-level diffs, file history, tree changes, risk scoring, and blame data. Built for devs who want smarter insight into their codebase — no cloud, no clutter, just local clarity.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks