GitLens — Git superchargedSupercharge Git within VS Code — Visualize code authorship at a glance via Git blame annotations and CodeLens, seamlessly navigate and explore Git repositories, gain valuable insights via rich visualizations and powerful comparison commands, and so much more Installation Launch VS Code Quick Open ( Ctrl+P), paste the following command, and press enter.Copied to clipboard |
GitLens — Supercharge Git in VS Code
GitLens is a powerful open-source extension for Visual Studio Code. GitLens supercharges your Git experience in VS Code. Maintaining focus is critical, extra time spent context switching or missing context disrupts your flow. GitLens is the ultimate tool for making Git work for you, designed to improve focus, productivity, and collaboration with a powerful set of tools to help you and your team better understand, write, and review code. GitLens sets itself apart from other Git tools through its deep level of integration, versatility, and ease of use. GitLens sits directly within your editor, reducing context switching and promoting a more efficient workflow. We know Git is hard and strive to make it as easy as possible while also going beyond the basics with rich visualizations and step-by-step guidance and safety, just to name a few. Getting Started
Install GitLens by clicking Use Is GitLens Free?All features are free to use on all repos, except for features,
See the FAQ for more details. Features | Labs | Pro | FAQ | Support and Community | Contributing | Contributors | License Discover Powerful FeaturesQuickly glimpse into when, why, and by whom a line or code block was changed. Zero-in on the most important changes and effortlessly navigate through history to gain further insights as to how a file or individual line's code evolved. Visualize code authorship at a glance via Git blame annotations and Git CodeLens. Seamlessly explore Git repositories with the visually-rich Commit Graph. Gain valuable insights via GitLens Inspect, and much more.
Blame, CodeLens, and HoversGain a deeper understanding of how code changed and by whom through in-editor code annotations and rich hovers. Inline and Status Bar BlameProvides historical context about line changes through unobtrusive blame annotation at the end of the current line and on the status bar. 
💡 Use the Git CodeLensAdds contextual and actionable authorship information at the top of each file and at the beginning of each block of code.
Rich HoversHover over blame annotations to reveal rich details and actions. 
File AnnotationsUse on-demand whole file annotations to see authorship, recent changes, and a heatmap. Annotations are rendered as visual indicators directly in the editor. 
💡 On an active file, use the Revision NavigationWith just a click of a button, you can navigate backwards and forwards through the history of any file. Compare changes over time and see the revision history of the whole file or an individual line. 
Side Bar ViewsOur views are arranged for focus and productivity, although you can easily drag them around to suit your needs. 
💡 Use the GitLens InspectAn x-ray or developer tools inspector into your code, focused on providing contextual information and insights to what you're actively working on.
GitLensQuick access to many GitLens features. Also the home of GitKraken teams and collaboration services (e.g. GitKraken Workspaces), help, and support.
Source ControlShows additional views that are focused on exploring and managing your repositories.
(Bottom) PanelConvenient and easy access to the Commit Graph with a dedicated details view.
Commit Graph ✨Easily visualize your repository and keep track of all work in progress. Use the rich commit search to find exactly what you're looking for. Its powerful filters allow you to search by a specific commit, message, author, a changed file or files, or even a specific code change. 
💡Quickly toggle the Graph via the 💡Maximize the Graph via the GitKraken Workspaces ☁️ and Focus ✨GitKraken Workspaces allow you to easily group and manage multiple repositories together, accessible from anywhere, streamlining your workflow. Create workspaces just for yourself or share (coming soon in GitLens) them with your team for faster onboarding and better collaboration. Focus brings all of your GitHub pull requests and issues into a unified actionable view to help to you more easily juggle work in progress, pending work, reviews, and more. Quickly see if anything requires your attention while keeping you focused. 
Visual File History ✨Quickly see the evolution of a file, including when changes were made, how large they were, and who made them. Use it to quickly find when the most impactful changes were made to a file or who best to talk to about file changes and more. 
Worktrees ✨Efficiently multitask by minimizing the context switching between branches, allowing you to easily work on different branches of a repository simultaneously. Avoid interrupting your work in progress when needing to review a pull request. Simply create a new worktree and open it in a new VS Code window, all without impacting your other work. 
Interactive Rebase EditorEasily visualize and configure interactive rebase operations with the intuitive and user-friendly Interactive Rebase Editor. Simply drag & drop to reorder commits and select which ones you want to edit, squash, or drop. 
Comprehensive CommandsStop worrying about memorizing Git commands; GitLens provides a rich set of commands to help you do everything you need. Git Command PaletteA guided, step-by-step experience for quickly and safely executing Git commands. 
Quick Access CommandsUse a series of new commands to:
IntegrationsContext switching kills productivity. GitLens not only reveals buried knowledge within your repository, it also brings additional context from issues and pull requests providing you with a wealth of information and insights at your fingertips. Simplify your workflow and quickly gain insights with automatic linking of issues and pull requests across multiple Git hosting services including GitHub, GitHub Enterprise ✨, GitLab, GitLab self-managed ✨, Gitea, Gerrit, Google Source, Bitbucket, Bitbucket Server, Azure DevOps, and custom servers. All integration provide automatic linking, while rich integrations with GitHub & GitLab offer detailed hover information for autolinks, and correlations between pull requests, branches, and commits, as well as user avatars for added context. Define your own autolinksUse autolinks to linkify external references, like Jira issues or Zendesk tickets, in commit messages. GitKraken LabsOur incubator for experimentation and exploration with the community to gather early reactions and feedback. Below are some of our current experiments. 🧪AI Explain CommitUse the Explain panel on the Commit Details view to leverage AI to help you understand the changes introduced by a commit. 🧪Automatically Generate Commit MessageUse the Ready for GitKraken Pro?When you're ready to unlock the full potential of GitLens and enjoy all the benefits on your privately hosted repos, consider upgrading to GitKraken Pro. With GitKraken Pro, you'll gain access to ✨ features on privately hosted repos and ☁️ features based on the Pro plan. To learn more about the pricing and the additional ✨ and ☁️ features offered with GitKraken Pro, visit the GitLens Pricing page. Upgrade to GitKraken Pro today and take your Git workflow to the next level! FAQIs GitLens free to use?Yes. All features are free to use on all repos, except for features,
While GitLens offers a remarkable set of free features, a subset of features tailored for professional developers and teams, marked with a ✨, require a trial or paid plan for use on privately hosted repos — use on local or publicly hosted repos is free for everyone. Additionally some features marked with a ☁️, rely on GitKraken Dev Services which requires a GitKraken account and access is based on your plan, e.g. Free, Pro, etc. Preview ✨ features instantly for free for 3 days without an account, or start a free GitKraken trial to get an additional 7 days and gain access to ☁️ features to experience the full power of GitLens. Are ✨ and ☁️ features free to use?✨ features are free for use on local and publicly hosted repos, while a paid plan is required for use on privately hosted repos. ☁️ feature access is based on your plan including a Free plan. Where can I find pricing?Visit the GitLens Pricing page for detailed pricing information and feature matrix for plans. Support and CommunitySupport documentation can be found on the GitLens Help Center. If you need further assistance or have any questions, there are various support channels and community forums available for GitLens: Issue Reporting and Feature RequestsFound a bug? Have a feature request? Reach out on our GitHub Issues page. DiscussionsJoin the GitLens community on GitHub Discussions to connect with other users, share your experiences, and discuss topics related to GitLens. GitKraken SupportFor any issues or inquiries related to GitLens, you can reach out to the GitKraken support team via the official support page. They will be happy to assist you with any problems you may encounter. With GitKraken Pro, you gain access to priority email support from our customer success team, ensuring higher priority and faster response times. Custom onboarding and training are also available to help you and your team quickly get up and running with a GitKraken Pro plan. ContributingGitLens is an open-source project that greatly benefits from the contributions and feedback from its community. Your contributions, feedback, and engagement in the GitLens community are invaluable, and play a significant role in shaping the future of GitLens. Thank you for your support! Code ContributionsWant to contribute to GitLens? Follow the CONTRIBUTING docs to get started. Documentation ContributionsContributions to the documentation are greatly appreciated. If you find any areas that can be improved or have suggestions for new documentation, you can submit them as pull requests to the GitLens Docs repository. ContributorsA big thanks to the people that have contributed to this project 🙏❤️:
Also special thanks to the people that have provided support, testing, brainstorming, etc:
And of course the awesome vscode team! LicenseThis repository contains both OSS-licensed and non-OSS-licensed files. All files in or under any directory named "plus" fall under LICENSE.plus. The remaining files fall under the MIT license. |
