Thanks to visit codestin.com
Credit goes to github.com

Skip to content

mashurr/git-pinned-commit-highlighter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Git Pinned Commit Highlighter

Visual Studio Marketplace GitHub

The ultimate VS Code extension for visual git diff comparison! Pin any commit, branch, or reference and instantly see what's changed in your files with elegant gutter indicators.

๐Ÿš€ Why You Need This Extension

Ever wished you could easily compare your current work against a specific commit or branch? Tired of switching between terminal and editor to see git diffs? This extension transforms your VS Code editor into a powerful visual diff tool that highlights changes right in the gutter - just like VS Code's native git integration, but for ANY reference you choose!

โœจ Key Features

๐Ÿ“Œ Flexible Reference Pinning

  • Pin any git reference: commits, branches, remote branches, tags
  • Smart validation ensures your reference exists
  • One-click toggle from the status bar
  • Support for relative references (HEAD~2, main~5)

๐ŸŽจ Visual Change Indicators

  • ๐ŸŸก Yellow bars for modified lines
  • ๐ŸŸข Green bars for added lines
  • ๐Ÿ”ป Red down arrows for deleted content
  • Clean, VSCode-native styling that doesn't interfere with your code

โšก Real-time Updates

  • Automatic highlighting when switching files
  • Instant refresh on file save
  • Seamless integration with your workflow

๐ŸŽฏ Smart Comparison

  • Compare against HEAD by default
  • Switch to any pinned reference instantly
  • Perfect for feature branch development, code reviews, and refactoring

๐ŸŽฌ See It In Action

Feature Demo

Pin a commit and see your changes highlighted instantly

๐Ÿ›  How It Works

  1. Click the pin icon (๐Ÿ“Œ) in your status bar (bottom right)
  2. Enter any git reference - branch name, commit SHA, or remote branch
  3. Watch the magic happen - your file changes are highlighted immediately!

Example References You Can Pin:

main                    # Branch name
origin/develop         # Remote branch
a1b2c3d                # Commit SHA (short or full)
HEAD~5                 # Relative reference
v1.0.0                 # Tag
upstream/master        # Upstream branch

๐ŸŽฏ Perfect Use Cases

๐Ÿ” Code Reviews

Pin the base branch and see exactly what changed in your feature branch

๐Ÿšง Feature Development

Compare your work-in-progress against the original starting point

๐Ÿ”„ Refactoring

Keep track of modifications while restructuring code

๐Ÿ› Bug Investigation

Compare current state with known good commits

๐Ÿ“Š Release Preparation

Review all changes since the last release tag

๐Ÿš€ Getting Started

  1. Install the extension from the VS Code Marketplace
  2. Open any git repository in VS Code
  3. Click the ๐Ÿ“Œ icon in the bottom-right status bar
  4. Enter a git reference to pin (e.g., main, origin/develop)
  5. Start coding and see your changes highlighted!

โš™๏ธ Requirements

  • Git repository: Your project must be a git repository
  • VS Code 1.90.0+: Latest VS Code for the best experience
  • Git CLI: Must be available in your system PATH

๐ŸŽ›๏ธ Commands

Command Description
Toggle Pinned Commit Pin a git reference for comparison
Change/Clear Modify or remove the current pinned reference

Access via:

  • Status bar click (๐Ÿ“Œ icon)
  • Command Palette: Toggle Pinned Commit

๐Ÿ”ง Extension Settings

This extension works out of the box with no configuration required! The pinned reference is maintained per workspace session.

โš ๏ธ Known Issues

  • Gutter icons may not appear in some VS Code themes (working on universal compatibility)
  • Large repositories might experience slight delays when switching references
  • Binary files are not highlighted (git limitation)
  • Down arrow indicators for deletions appear in gutter area

๐Ÿ”„ Release Notes

1.0.0 - Initial Release

  • โœ… Pin any git reference (commits, branches, remotes)
  • โœ… Visual gutter indicators for all change types
  • โœ… Real-time file highlighting
  • โœ… Status bar integration
  • โœ… Reference validation

Future Plans

  • ๐Ÿ”ฎ Multi-reference comparison
  • ๐Ÿ”ฎ Customizable colors and indicators
  • ๐Ÿ”ฎ File-level change statistics
  • ๐Ÿ”ฎ Integration with git timeline

๐Ÿค Contributing

Found a bug or have a feature request? We'd love to hear from you!

๐Ÿ“„ License

MIT License - feel free to use this extension in your projects!

โญ Love This Extension?

If this extension saves you time and makes your development workflow smoother, consider:

  • โญ Rating it on the VS Code Marketplace
  • ๐Ÿฆ Sharing it with your developer friends
  • ๐Ÿ’ Contributing to make it even better

Happy coding! ๐Ÿš€

Transform your git workflow with visual diff highlighting - pin any reference and code with confidence.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published