git-insights-tool

An interactive, real-time terminal utility to visualize your Git branch histories and preview merge conflicts in a clean browser dashboard.

Quick Start

Install the package globally via npm:

npm install -g git-insights-tool

Once installed, navigate into any local Git repository inside your terminal and run the command:

git-insights-tool

The engine will automatically spin up a local server layer and open your default web browser to your custom interactive repository dashboard!

Why Use GitInsights?

Divergent History Visualization: Stop trying to interpret unreadable git log --graph --oneline outputs. See your feature branches sprout out sideways and merge back together clearly.

Risk-Free Merge Previews: The "Merge Check" utility runs complex git 3-way merge operations completely in system memory. It finds structural line-by-line merge conflicts across branches without modifying or breaking your local workspace files.

Zero Overhead Setup: No heavy extensions or global desktop applications required. It's a lightweight CLI utility that lives inside your command line and stays out of your way.

Usage Tips

Checking Your Configurations Ensure your global installation maps command pathways accurately. If you don't see the executable shortcut generated beside your other packages, verify your target environment paths or trigger a clean cache reset:

npm uninstall -g git-insights-tool
npm cache clean --force
npm install -g git-insights-tool

Making the Graph Explode (Simulating Branches) To see the network layout split into an advanced branching layout instead of a straight linear timeline, run parallel development branches locally:

git checkout -b feature/sports-layout
# ... modify some code and make a commit ...
git checkout main
# ... modify the same file and make a divergent commit ...

Fire up git-insights-tool to watch the graph node systems map out the split pathways instantly!

🛠️ Requirements Node.js: v16.x or higher Git: Installed on your local machine system environment path variables.