@ -69,15 +69,17 @@ Here are just some of the **features** that GitLens provides,
- user-defined [**modes**](#modes- 'Jump to Modes') for quickly toggling between sets of settings
- and so much more 😁
# GitLens+ [#](#gitlens+- 'GitLens+')
# GitLens+ Features [#](#gitlens+-features- 'GitLens+ Features')
GitLens+ adds all-new, completely optional, features that enhance your current GitLens experience when you sign in with a free account. [GitLens+ features](https://gitkraken.com/gitlens/plus-features?utm_source=gitlens-extension&utm_medium=in-app-links&utm_campaign=gitlens-plus-links) are free for local and public repos, no account required, while private repos require GitLens Pro.
Powerful, all-new, and completely optional, features that enhance your GitLens experience.
> All other GitLens features are always accessible, without an account, and will continue to evolve and be invested in.
[GitLens+ features](https://gitkraken.com/gitlens/plus-features?utm_source=gitlens-extension&utm_medium=in-app-links&utm_campaign=gitlens-plus-links) are free for local and public repos, no account required, while upgrading to GitLens Pro gives you access on private repos.
> All other GitLens features are always accessible.
## Does this affect existing features?
No, the introduction of GitLens+ has no impact on existing GitLens features, so you won't lose access to any of the GitLens features you know and love. In fact, we are heavily investing in enhancing and expanding the GitLens feature set. Upgrading to GitLens Pro additionally gives you access to GitLens+ features on private repos.
No, the introduction of GitLens+ features has no impact on existing GitLens features, so you won't lose access to any of the GitLens features you know and love. In fact, we are heavily investing in enhancing and expanding the GitLens feature set. Additionally, GitLens+ features are freely available to everyone for local and public repos, while upgrading to GitLens Pro gives you access on private repos.
The _Commit Graph_ helps you to easily visualize branch structure and commit history. Not only does it help you verify your changes, but also easily see changes made by others and when. Selecting a row within the graph will open in-depth information about a commit or stash in the new [Commit Details view](#commit-details-view-).
The _Commit Graph_ helps you easily visualize and keep track of all work in progress. Not only does it help you verify your changes, but also easily see changes made by others and when. Selecting a row within the graph will open in-depth information about a commit or stash in the new [Commit Details view](#commit-details-view-).
Use the rich commit search to find exactly what your looking for. It's powerful filters allow you to search by a specific commit, message, author, a changed file or files, or even a specific code change.
## Visual File History view [#](#visual-file-history-view- 'Visual File History view')
@ -95,6 +99,8 @@ The _Commit Graph_ helps you to easily visualize branch structure and commit his
The _Visual File History_ view allows you to 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.
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.
@ -105,7 +111,11 @@ Additionally, each commit's additions and deletions are visualized as color-code
Worktrees allow you to easily work on different branches of a repository simultaneously. You can create multiple working trees, each of which can be opened in individual windows or all together in a single workspace.
Worktrees help you 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.
You can create multiple working trees, each of which can be opened in individual windows or all together in a single workspace.
# Features
@ -292,7 +302,7 @@ GitLens adds many side bar views to provide additional rich functionality. The d
The _Commit Details_ view provides rich details for commits and stashes: author, commit ID, links to Pull Requests and Issues, autolinks, changed files, and more.
The _Commit Details_ view provides rich details for commits and stashes: author, commit ID, autolinks to pull requests and issues, changed files, and more.
"description":"Check out the all-new, completely optional, GitLens+ features.\n\n[Learn about GitLens+ features](command:gitlens.plus.learn?false \"Open the GitLens+ features walkthrough\")",
"title":"Introducing GitLens+ Features",
"description":"Check out the powerfull, all-new, and completely optional, GitLens+ features.\n\n[Learn about GitLens+ features](command:gitlens.plus.learn?false \"Open the GitLens+ features walkthrough\")",
"description":"Get even more out of GitLens in VS Code!",
"steps":[
{
"id":"gitlens.plus.intro.tryNow",
"title":"Introducing GitLens+",
"title":"Introducing GitLens+ Features",
"description":"Try GitLens+ features on private repos, free for 3 days, without an account.\n\n[Start a GitLens Pro Trial](command:gitlens.plus.startPreviewTrial)",
"media":{
"markdown":"walkthroughs/plus/1-intro.md"
"markdown":"walkthroughs/plus/intro.md"
},
"when":"gitlens:plus:state == 0"
},
{
"id":"gitlens.plus.intro.trial",
"title":"Introducing GitLens+",
"title":"Introducing GitLens+ Features",
"description":"During your GitLens Pro trial, you have additional access to GitLens+ features on private repos.",
"description":"Do you want to continue to use GitLens+ features on private repos, free for an additional 7-days?\n\n[Extend Trial](command:gitlens.plus.loginOrSignUp)",
"media":{
"markdown":"walkthroughs/plus/1-intro.md"
"markdown":"walkthroughs/plus/intro.md"
},
"when":"gitlens:plus:state == 2"
},
{
"id":"gitlens.plus.intro.signIn",
"title":"Introducing GitLens+",
"title":"Introducing GitLens+ Features",
"description":"Do you want to continue to use GitLens+ features on private repos?\n\n[Upgrade to Pro](command:gitlens.plus.command:gitlens.plus.purchase)",
"media":{
"markdown":"walkthroughs/plus/1-intro.md"
"markdown":"walkthroughs/plus/intro.md"
},
"when":"gitlens:plus:state == 4"
},
{
"id":"gitlens.plus.intro",
"title":"Introducing GitLens+",
"title":"Introducing GitLens+ Features",
"media":{
"markdown":"walkthroughs/plus/1-intro.md"
"markdown":"walkthroughs/plus/intro.md"
},
"when":"gitlens:plus:state == 5"
},
@ -12494,7 +12494,7 @@
"title":"Visualize file history",
"description":"A more visual way to analyze and explore changes made to a file.\n\n[Open Visual File History view](command:gitlens.showTimelineView)",
"description":"Create worktrees to have multiple branches checked-out at once on the same repository.\n\n[Open Worktrees view](command:gitlens.showWorktreesView)",
"media":{
"markdown":"walkthroughs/plus/2-worktrees.md"
"markdown":"walkthroughs/plus/worktrees.md"
}
},
{
@ -12517,25 +12517,34 @@
"title":"Try GitLens Pro",
"description":"Try GitLens+ features on private repos, free for 3 days, without an account.\n\n[Start a GitLens Pro Trial](command:gitlens.plus.startPreviewTrial)",
"media":{
"markdown":"walkthroughs/plus/5-try-now.md"
"markdown":"walkthroughs/plus/try-now.md"
},
"when":"gitlens:plus:state == 0"
},
{
"id":"gitlens.plus.extend",
"title":"Extend Your GitLens Pro Trial",
"description":"Sign in for use on public repos and get an additional 7 day trial for private repos.\n\n[Extend Trial](command:gitlens.plus.loginOrSignUp)",
"description":"Extend your trial to get an additional 7-days of GitLens+ features on private repos for free.\n\n[Extend Trial](command:gitlens.plus.loginOrSignUp)",
"media":{
"markdown":"walkthroughs/plus/5-try-now.md"
"markdown":"walkthroughs/plus/try-now.md"
},
"when":"gitlens:plus:state == 2"
},
{
"id":"gitlens.plus.signIn",
"id":"gitlens.plus.purchase",
"title":"Upgrade to GitLens Pro",
"description":"Do you want to continue to use GitLens+ features on private repos?\n\n[Upgrade to Pro](command:gitlens.plus.purchase)",
"description":"Want to use GitLens+ features on private repos?\n\n[Upgrade to Pro](command:gitlens.plus.purchase)",
GitLens+ adds all-new, completely optional, features that enhance your current GitLens experience. These features are free for local and public repos, no account required.
Powerful, all-new, and completely optional, features that enhance your GitLens experience.
[GitLens+ features](https://gitkraken.com/gitlens/plus-features?utm_source=gitlens-extension&utm_medium=in-app-links&utm_campaign=gitlens-plus-links) are free for local and public repos, no account required, while upgrading to GitLens Pro gives you access on private repos.
[Learn more about GitLens+ features](https://gitkraken.com/gitlens/plus-features?utm_source=gitlens-extension&utm_medium=in-app-links&utm_campaign=gitlens-plus-links 'Learn more')
<spanclass="codicon codicon-info">All other GitLens features are always accessible</span>
GitLens+ features include the Commit Graph, Visual File History, Worktrees, and more.
GitLens+ adds all-new, completely optional, features that enhance your current GitLens experience. GitLens+ features are free for local and public repos, no account required, while private repos require GitLens Pro.
ⓘ All other GitLens features are always accessible, without an account, and will continue to evolve and be invested in.
[Learn more about GitLens+](https://gitkraken.com/gitlens/plus-features?utm_source=gitlens-extension&utm_medium=in-app-links&utm_campaign=gitlens-plus-links 'Learn more')
GitLens+ features include the Commit Graph, Visual File History, Worktrees, and more.
No, the introduction of GitLens+ has no impact on existing GitLens features, so you won't lose access to any of the GitLens features you know and love. In fact, we are heavily investing in enhancing and expanding the GitLens feature set. Upgrading to GitLens Pro additionally gives you access to GitLens+ features on private repos.
Worktrees make developing on and testing multiple branches easier, by minimizing the context switching between branches. Worktrees allow you to easily work on different branches of a repository simultaneously. You can create multiple working trees, each of which can be opened in individual windows or all together in a single workspace.
_Note: Worktrees do not yet work with VS Code on the Web._
The Commit Graph helps you to easily visualize branch structure and commit history. Not only does it help you verify your changes, but also easily see changes made by others and when.
The Commit Graph helps you easily visualize and keep track of all work in progress. Not only does it help you verify your changes, but also easily see changes made by others and when.
Use the rich commit search to find exactly what your looking for. It's powerful filters allow you to search by a specific commit, message, author, a changed file or files, or even a specific code change.
Powerful, all-new, and completely optional, features that enhance your current GitLens experience.
[GitLens+ features](https://gitkraken.com/gitlens/plus-features?utm_source=gitlens-extension&utm_medium=in-app-links&utm_campaign=gitlens-plus-links) are free for local and public repos, no account required, while upgrading to GitLens Pro gives you access on private repos.
[Learn more about GitLens+ features](https://gitkraken.com/gitlens/plus-features?utm_source=gitlens-extension&utm_medium=in-app-links&utm_campaign=gitlens-plus-links 'Learn more')
$(info) All other GitLens features are always accessible
GitLens+ features include the Commit Graph, Visual File History, Worktrees, and more.
No, the introduction of GitLens+ features has no impact on existing GitLens features, so you won't lose access to any of the GitLens features you know and love. In fact, we are heavily investing in enhancing and expanding the GitLens feature set. Additionally, GitLens+ features are freely available to everyone for local and public repos, while upgrading to GitLens Pro gives you access on private repos.
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.
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.
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.
Worktrees help you 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.
You can create multiple working trees, each of which can be opened in individual windows or all together in a single workspace.
_Note: Worktrees do not yet work with VS Code on the Web._