- adds headings, and moves the majority of text content to the body of each step
- most steps now have a simple, one-line description
- adds "try now" section to premium feature walkthrough with a button to try
- adds and updates content in premium feature introduction step
- removes an unnecessary file
"description":"At the end of every line of code and in the status bar, GitLens exposes details about the last commit that modified that line, including the author, when the commit was made, and other information like pull request details. Hovering over these blame annotations will reveal more details and links to explore more about the commit.",
"description":"Current line blame provides historical context about line changes.",
"description":"At the top of each file and at the beginning of each block of code, GitLens exposes the most recent commit and number of authors. It does this by leveraging CodeLens, one of the most powerful tools inside VS Code, which provides clickable links exposing commit details and allows you to select from a quick pick menu to compare, navigate and further explore each commit.",
"description":"CodeLens adds contextual authorship information and links at the top of each file and at the beginning of each block of code.",
"description":"With just a click of a button, you can navigate backwards and forwards through any file's history. Compare changes over time and see the revision history of the whole file or every individual line of code. Customizable and unobtrusive Git blame annotations are still shown on every line, telling you the author, date, and message for the last commit!",
"description":"See customizable file annotations in the editor's status bar and in the gutter, the space beside the line number. Choose between:\n\nBlame – showing the commit and author for each line.\n\nChanges – highlighting any local, unpublished, changes or lines changed by the most recent commit.\n\nHeatmap – to show how recently lines were changed relative to all the other changes in the file.",
"description":"File annotations place visual indicators in the gutter and status bar that provide additional context about changes. ",
"title":"View more source control details in the side bar",
"description":"GitLens adds side bar views that provide rich source control details and functionality. GitLens views for Commits, File History, Branches, Remotes, Stashes, Tags, Contributors, and the Search & Compare can be displayed in either the Source Control side bar or on the GitLens side bar.",
"description":"Additional views expose even more Git functionality in your side bar.",
"description":"GitLens provides rich integrations with many remote providers, including GitHub, GitHub Enterprise, GitLab, Gitea, Gerrit, Bitbucket, Bitbucket Server, Azure DevOps and custom servers. Quickly gain insights from pull requests and issues without leaving your codebase.\n\nAll Git host integrations provide issue and pull request auto-linking, while advanced integrations (e.g. GitHub) provide more detailed hover information, plus the ability to associate pull requests with branches/commits, and avatars.",
"description":"Quickly gain insights from pull requests and issues without leaving your codebase.",
"description":"The Git Command Palette provides guided, step-by-step access to many common Git commands, as well as quick access to commits (history and search), stashes, and status (current branch and working tree).",
"title":"Visualize interactive rebase operations",
"description":"A user-friendly editor to easily configure an interactive rebase session. Simply drag & drop to reorder commits and select which ones you want to edit, squash, or drop.",
"description":"New premium features like Worktrees and Visual File History can be unlocked with a GitLens Free+ account. Additional premium features like GitHub Enterprise and GitLab Self-Managed integrations, and a visual commit graph are coming soon.\n\n",
"description":"Create Worktrees that allow multiple branches to be checked-out at once on the same repository. This makes it easier to develop on, or test multiple branches, by minimizing the context switching between branches.\n\nNote: Worktrees do not yet work with VS Code on the web.",
"description":"Create Worktrees that allow multiple branches to be checked-out at once on the same repository.",
"description":"Clearly see the history of a file, including: when changes were made, how large they were, and who made them. Authors who have contributed changes to a file are on one axis, and dates on the other. Color-coded dots represent points in time where that author made changes to the file, and vertical lines represent the magnitude of the change in two colors: green for lines added, and red for lines removed.",
"description":"A more visual way to analyze and explore changes made to a file.",
"description":"You can expect more premium features like the GitKraken commit graph, which will help you visualize branch structure and commit history. It not only helps verify your recent Git actions on the repo, but also shows who made what code changes and when.",
"description":"Try premium features now, without an account, for 3 days.\n\n[Try Premium GitLens Features](command:gitlens.premium.startPreviewTrial)",
<imgsrc="../../images/docs/rebase.gif"alt="Interactive rebase editor"/>
</p>
A user-friendly editor to easily configure an interactive rebase session. Simply drag & drop to reorder commits and select which ones you want to edit, squash, or drop.
<imgsrc="../../images/docs/current-line-blame.png"alt="Current Line Blame"/>
</p>
Adds a [customizable](command:gitlens.showSettingsPage?%22current-line%22 'Jump to the Current Line Blame settings') unobtrusive **blame annotation** at the end of the current line
- Contains the author, date, and message of the current line's most recent commit (by default)
- Adds a [_Toggle Line Blame Annotations_](command:gitlens.toggleLineBlame) command to toggle the blame annotation on and off
<palign="center">
<imgsrc="../../images/docs/current-line-blame.png"alt="Current Line Blame"/>
</p>
Hovering over these blame annotaions will reveal more details and links to explore more about the commit.
<palign="center">
<imgsrc="../../images/docs/hovers-current-line.png"alt="Current Line Blame Hover"/>
With just a click of a button, you can navigate backwards and forwards through any file's history. Compare changes over time and see the revision history of the whole file or every individual line of code. Customizable and unobtrusive Git blame annotations are still shown on every line, telling you the author, date, and message for the last commit!
<imgsrc="../../images/docs/views-layout-gitlens.png"alt="GitLens Side Bar Views"width="45%"/>
<imgsrc="../../images/docs/views-layout-scm.png"alt="Source Control Side Bar Views"width="45%"/>
</p>
GitLens adds side bar views for Commits, File History, Branches, Remotes, Stashes, Tags, Contributors, and the Search & Compare that provide rich source control details and functionality.
These views can be displayed in either the **GitLens** side bar or on the **Source Control** side bar.
<imgsrc="../../images/docs/hosting-integrations.png"alt="Hosting service integrations"/>
</p>
GitLens provides rich integrations with many remote providers, including GitHub, GitHub Enterprise, GitLab, Gitea, Gerrit, Bitbucket, Bitbucket Server, Azure DevOps and custom servers.
All Git host integrations provide issue and pull request auto-linking, while advanced integrations (e.g. GitHub) provide more detailed hover information, plus the ability to associate pull requests with branches/commits, and avatars.
The Git Command Palette provides guided, step-by-step access to many common Git commands, as well as quick access to commits (history and search), stashes, and status (current branch and working tree).
New premium features like Worktrees and Visual File History can be unlocked with a GitLens Free+ account. Additional premium features like a visual commit graph, and integrations for GitHub Enterprise and GitLab Self-Managed repositories are coming soon.
**Does this affect existing features?**
No, the introduction of premium features has no impact on GitLens features that existed prior to v12.0, so you won't lose access to any of the GitLens features you know and love. Creating an account simply gives you access to new, premium features that will enable you to get even more out of Git in VS Code!
Free+ accounts will be able to access premium features on all public repostories, and a paid account will be required to access premium features on private repositories.
[Learn More About Premium GitLens Features](https://gitkraken.com/gitlens/premium-features)
<imgsrc="../../images/docs/visual-file-history-hover.png"alt="Visual File History View"/>
</p>
The Visual File History allows you to quickly see the evolution of a file, including when changes were made, how large they were, and who made them.
Authors who have contributed changes to the file are on the left y-axis to create a swim-lane of their commits over time (the x-axis). Commit are plotted as color-coded (per-author) bubbles, whose size represents the relative magnitude of the changes.
Additionally, each commit's additions and deletions are visualized as color-coded, stacked, vertical bars, whose height represents the number of affected lines (right y-axis). Added lines are shown in green, while deleted lines are red.
<imgsrc="../../images/docs/coming-soon-commit-graph.png"alt="Worktrees View in Side Bar"/>
</p>
You can expect more premium features like a visual commit graph for better repo visualization, and integrations with hosting services like GitHub Enterprise and GitLab Self-Managed.