Git Ranger
A visually stunning Git management extension for Visual Studio 2022/2026, with theme-adaptive vibrant colors. 🎨✨
🚀 Features
🔍 Inline Blame Annotations
See who changed each line directly in the editor — author name, commit date, and message displayed right at the end of each line!
- 🎨 Color-coded by author — each contributor gets a unique vibrant color
- 🔥 Heat map mode — green = recent, red = old (optional)
- 👁️ Configurable opacity and display format
- 💬 Hover for full commit details
📊 Blame Gutter Margin
A visual indicator in the editor margin showing commit history at a glance.
- 📈 Age bars showing relative commit age
- 🎯 Author color indicators
- 📋 Click to copy commit SHA
- 🔎 Hover for commit details
📍 Status Bar Blame
See blame info for the current line right in the Visual Studio status bar — updates instantly as you navigate!
- ⚡ Real-time updates — blame follows your cursor
- 🎛️ Customizable format — choose what to display with
{author}, {date}, {message}, {sha} placeholders
- 📅 Relative or absolute dates — "2 days ago" or "1/21/2026"
- ✂️ Auto-truncate — configurable max length keeps your status bar tidy
🔮 What's Next?
Check out our issues list to see what features are planned and vote on what you'd like to see next!
📦 Installation
From Visual Studio Marketplace
From Source
# 1. Clone the repository
git clone https://github.com/CodingWithCalvin/VS-GitRanger.git
# 2. Open in Visual Studio 2022
# 3. Build the solution (F5 to debug)
# 4. VSIX will be created in the output directory
⚙️ Configuration
Configure Git Ranger via Tools → Options → Git Ranger
🏷️ Blame Settings
| Setting |
Description |
Default |
| Enable Inline Blame |
Show blame at end of lines |
✅ true |
| Enable Blame Gutter |
Show blame in margin |
✅ true |
| Show Author Name |
Display author in inline blame |
✅ true |
| Show Commit Date |
Display date in inline blame |
✅ true |
| Show Commit Message |
Display message in inline blame |
✅ true |
| Date Format |
relative or custom format string |
relative |
🎨 Color Settings
| Setting |
Description |
Default |
| Color Mode |
Author, Age, or None |
Author |
| Max Age (days) |
Maximum age for heat map |
365 |
🖥️ Display Settings
| Setting |
Description |
Default |
| Inline Blame Opacity |
Transparency (0.0 - 1.0) |
0.7 |
| Compact Mode |
Condensed display format |
❌ false |
| Gutter Width |
Width in pixels |
40 |
| Show Age Bars |
Visual age indicators |
✅ true |
📍 Status Bar Settings
| Setting |
Description |
Default |
| Enable Status Bar Blame |
Show blame in status bar |
✅ true |
| Format |
Template with {author}, {date}, {message}, {sha} |
{author}, {date} • {message} |
| Use Relative Dates |
Show "2 days ago" vs absolute date |
✅ true |
| Max Length |
Truncate long messages (0 = unlimited) |
100 |
🔧 Diagnostics
| Setting |
Description |
Default |
| Log Level |
Output pane verbosity: None, Error, Info, Verbose |
Error |
Logs are written to the "Git Ranger" output pane in Visual Studio.
📋 Requirements
- 💻 Visual Studio 2022 (17.0) or later
- 🔧 .NET Framework 4.8
🛠️ Technology Stack
| Component |
Technology |
| 🔗 Git Integration |
LibGit2Sharp |
| 🎨 UI Framework |
WPF |
| 📊 Graph Rendering |
SkiaSharp (planned) |
| 🔌 VS Integration |
Community.VisualStudio.Toolkit |
🤝 Contributing
Contributions are welcome! Feel free to submit issues and pull requests. 💪
- 🍴 Fork the repository
- 🌿 Create a feature branch (
git checkout -b feature/amazing-feature)
- 💾 Commit your changes (
git commit -m 'feat: add amazing feature')
- 📤 Push to the branch (
git push origin feature/amazing-feature)
- 🎉 Open a Pull Request
📄 License
This project is licensed under the MIT License — see the LICENSE file for details.
👥 Contributors
⭐ If you find Git Ranger useful, please consider giving it a star! ⭐
Made with ❤️ for the Visual Studio community from Coding With Calvin
