All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
gitlens.browseRepoBeforeRevision
) and Browse Repository from Before Here in New Window (gitlens.browseRepoBeforeRevisionInNewWindow
) commandsgitlens.copyCurrentBranch
) command to copy the current branch name to the clipboard — closes #1306 — thanks to PR #1307 by Ken Hom (@kh0m)gitlens.advanced.abbreviateShaOnCopy
setting to specify to whether to copy full or abbreviated commit SHAs to the clipboard. Abbreviates to the length of gitlens.advanced.abbreviatedShaLength
— closes #1062 — thanks to PR #1316 by Brendon Smith (@br3ndonland)gitlens.advanced.externalDiffTool
setting to specify an optional external diff tool to use when comparing files. Must be a configured Git difftool.gitlens.advanced.externalDirectoryDiffTool
setting to specify an optional external diff tool to use when comparing directories. Must be a configured Git difftool.gitlens.views.repositories.branches.showBranchComparison
setting to specify whether to show a comparison of the branch with a user-selected reference (branch, tag. etc) under under each branch in the Repositories viewgitlens.views.repositories.showBranches
setting to specify whether to show the branches for each repositorygitlens.views.repositories.showCommits
setting to specify whether to show the commits on the current branch for each repositorygitlens.views.repositories.showContributors
setting to specify whether to show the contributors for each repositorygitlens.views.repositories.showIncomingActivity
setting to specify whether to show the experimental incoming activity for each repositorygitlens.views.repositories.showRemotes
setting to specify whether to show the remotes for each repositorygitlens.views.repositories.showStashes
setting to specify whether to show the stashes for each repositorygitlens.views.repositories.showTags
setting to specify whether to show the tags for each repositorygitlens.views.repositories.showUpstreamStatus
setting to specify whether to show the upstream status of the current branch for each repositorygitlens.gitCommands.sortBy
setting to specify how Git commands are sorted in the Git Command Palettegitlens.heatmap.locations
setting to specify where the indicators of the gutter heatmap annotations will be showngitlens.fileAnnotations.command
setting to specify whether the file annotations button in the editor title shows a menu or immediately toggles the specified file annotations — closes #1165 thanks to PR #1171 by Raaj Patil (@arrpee)
gitlens.openFileOnRemoteFrom
) to open a file or revision on a specific branch or tag on the remote provider — closes #1071gitlens.copyRemoteFileUrlFrom
) to copy the url of a file or revision on a specific branch or tag the remote provider — closes #1071gitlens.connectRemoteProvider
) to connect to a supported remote service to enable a rich integrationgitlens.disconnectRemoteProvider
) to disconnect from a connected remote servicegitlens.integrations.enabled
setting to specify whether to enable rich integrations with any supported remote services — see #1208gitlens.terminalLinks.enabled
setting to specify whether to enable terminal links — autolinks in the integrated terminal to quickly jump to more details for commits, branches, tags, and more — closes #1284gitlens.defaultTimeFormat
setting to specify how times will be formatted by defaultgitlens.showWelcomeOnInstall
setting to specify whether to show the Welcome (Quick Setup) experience on first install — closes #1049 thanks to PR #1258 by Rickard (@rickardp)gitlens.d.ts
for API definitions--no-edit
) and Revert & Edit (--edit
) — closes #1269git shortlog
could hang (when there is no HEAD)gitlens.sortBranchesBy
and gitlens.sortTagsBy
settings where not honored in many quick pick menuscoldColor
and hotColor
breaks file blame & related functionalityX files changed
when comparing working tree with a branch having identical filesgitlens.codeLens.scopes
setting json schemagitlens.disableRebaseEditor
) to disable the interactive rebase editorgitlens.enableRebaseEditor
) to enable the interactive rebase editorgitlens.compareWith
) to compare two selected referencesmain...release/1.0
) to the Git Command Palette's history commandX files changed
when comparing working tree with a branch having identical filesAdds all-new views side bar views
Moves all GitLens views to the Source Control side bar by default. You can move them back to the GitLens side bar via the Set Views Layout (gitlens.setViewsLayout
) command or individually via drag and drop
Commits view — visualize, explore, and manage Git commits
Branches view — visualize, explore, and manage Git branches
Remotes view — visualize, explore, and manage Git remotes and remote branches
Stashes view — visualize, explore, and manage Git stashes
Tags view — visualize, explore, and manage Git tags
Contributors view — visualize, navigate, and explore contributors
(you)
suffixSearch & Compare view — search and explore commit histories by message, author, files, id, etc, or visualize comparisons between branches, tags, commits, and more
Disables the Repositories view by default, as it has been superseded by many new views. You can re-enable it by setting "gitlens.views.repositories.enabled": true
or via the GitLens Interactive Settings
Integrates line history into the File History view
Welcome view — quickly setup GitLens to meet your needs (for first time users only)
Adds a user-friendly interactive rebase editor to easily configure an interactive rebase session
Adds terminal links — ctrl+click
on autolinks in the integrated terminal to quickly jump to more details for commits, branches, tags, and more
Adds rich integration with GitHub
Adds a new and improved Gutter Heatmap file annotations, via the Toggle File Heatmap Annotations command (gitlens.toggleFileHeatmap
)
Adds a new and improved Gutter Changes file annotations, via the Toggle File Changes Annotations command (gitlens.toggleFileChanges
) — closes #396
Adds many refinements to the Git Command Palette (previously Git Commands), and adds new commands
right arrow
— reveals the selected branch in the Branches or Remotes view (or Repositories view, if enabled), if there is no text in the quick pick menualt+right arrow
, ctrl+right arrow
, cmd+right arrow
(macOS) — reveals the selected branch in the Branches or Remotes viewright arrow
— searches for the selected commit and shows the results in the Search Commits view, if there is no text in the quick pick menualt+right arrow
— searches for the selected commit and shows the results in the Search Commits viewctrl+right arrow
, cmd+right arrow
(macOS) — reveals the selected commit in the Commits view (or Repositories view, if enabled)git.useForcePushWithLease
setting on the push command--soft
) option to the reset commandAdds improved autolinks support
alphanumeric
flag to autolinks — closes #946Adds improved co-author support
gitlens.addAuthors
) command to the Source Control context menuAdds many new commands
gitlens.openFileFromRemote
) command — opens the local file from a remote file urlgitlens.setViewsLayout
) command — quickly switch between showing GitLens views in GitLens sidebar (default) and the Source Control sidebargitlens.views.switchToAnotherBranch
) command — to quickly switch the current branchgitlens.copyRemoteCommitUrl
) — copies the url of the current line commit on the remote providergitlens.copyRemoteBranchUrl
) — copies the url of a branch on the remote providergitlens.copyRemoteBranchesUrl
) — copies the url of the branches on the remote providergitlens.openComparisonOnRemote
) — opens the comparison on the remote providergitlens.copyRemoteComparisonUrl
) — copies the url of the comparison on the remote providergitlens.openPullRequestOnRemote
) — opens the pull request on the remote providergitlens.copyRemotePullRequestUrl
) — copies the url of the pull request on the remote providergitlens.copyRemoteRepositoryUrl
) — copies the url of the repository on the remote providerAdds alternative alt+click
commands for many of the Open * on Remote commands to alternatively copy the url to the clipboard
Adds an Open Commit on Remote command (with an Copy Remote Commit Url alt+click
command) to commits in the VS Code Timeline view
Adds ability to set the default remote from any of the Open * on Remote command quick pick menus
Adds Git Code Lens to markdown headers
Adds new Git Code Lens options to disable the click actions on both the recent change and authors code lens — closes #989 thanks to PR #1009 by Abdulrahman (Abdu) Assabri (@abdusabri)
Adds per-language customizations to the gitlens.codeLens.scopes
and gitlens.codeLens.symbolScopes
settings — closes #977
Adds new click behavior for changed files in GitLens views to open a diff of all contained changes
Adds a new gitlens.hovers.avatarSize
setting to customize the size of avatars shown in hovers
Adds Hide Avatars or Show Avatars menu command to many GitLens views to hide or show avatars
Adds Hide Date Markers or Show Date Markers menu command to many GitLens views to hide or show relative date markers
Adds real-time preview when editing format strings in the GitLens Interactive Settings
Adds a new commit format tokens: ${authorNotYou}
, ${agoOrDateShort}
, ${authorAgoOrDateShort}
, ${committerAgoOrDateShort}
Adds synchronized storage to avoid opening the Welcome page or showing a What's New notification on new machines when Settings Sync is enabled
Adds new Welcome and Open Settings menu commands to the GitLens gear menu in the Extensions sidebar — closes #952 & #953 thanks to PR #992 by Zeeshan Adnan (@zeeshanadnan)
Adds a new HEAD choice to the compare quick pick menu — closes #927
Adds support for .gitattributes
text conversion filters — closes #866 thanks to PR #1052 by Martin Campbell (@martin-css)
Adds week(s) ago to relative time formatting
Adds a limit of 5000 commits to the Load All command in GitLens views
Adds a Clear command to the branch comparison tool in GitLens views
Adds compact mode for showing branch and tag tips on commits in GitLens views
Adds Copy SHA command to branches and tags in GitLens views
gitlens.strings.codeLens.unsavedChanges.*
settingsscm/resourceGroup/context
and scm/resourceState/context
menu contributionsonStartupFinished
activation event.gitignored
files)"gitlens.views.lineHistory.enabled": true
gitlens.codeLens.scopesByLanguage
setting, use per-language gitlens.codeLens.scopes
andgitlens.codeLens.symbolScopes
settings insteadgitlens.gitCommands.search.showResultsInView
setting as it has been renamed to gitlens.gitCommands.search.showResultsInSideBar
gitlens.views.commitFileFormat
setting, use gitlens.views.formats.files.label
insteadgitlens.views.commitFileDescriptionFormat
setting, use gitlens.views.formats.files.description
insteadgitlens.views.commitFormat
setting, use gitlens.views.formats.commits.label
insteadgitlens.views.commitDescriptionFormat
setting, use gitlens.views.formats.commits.description
insteadgitlens.views.stashFileFormat
setting, use gitlens.views.formats.files.label
insteadgitlens.views.stashFileDescriptionFormat
setting, use gitlens.views.formats.files.description
insteadgitlens.views.stashFormat
setting, use gitlens.views.formats.stashes.label
insteadgitlens.views.stashDescriptionFormat
setting, use gitlens.views.formats.stashes.description
insteadgitlens.views.statusFileFormat
setting, use gitlens.views.formats.files.label
insteadgitlens.views.statusFileDescriptionFormat
setting, use gitlens.views.formats.files.description
insteadgitlens.gitCommands.closeOnFocusOut
setting)${changes}
token from commit description format by defaultgitlens.views.repositories.showTrackingBranch
setting as it is now always enabled--first-parent
for git log with --follow
ignoreCase
flag on autolinksgitlens.autolinks
setting to configure the autolinksJIRA-123 ⟶ https://jira.company.com/issue?query=123
):
"gitlens.autolinks": [{ "prefix": "JIRA-", "url": "https://jira.company.com/issue?query=<num>" }]
gitlens.views.highlightChanges
) to commits in GitLens views to highlight the changes lines in the current filegitlens.views.highlightRevisionChanges
) to commits in GitLens views to highlight the changes lines in the revisioncommit:
or #:
--ignore-revs-file
custom blame flag if it is supported by the current Git version and the file existsgitlens.sortTagsBy
settinggitlens.gitCommands
)
right arrow
— reveals the selected branch in the Repositories view, if there is no text in the quick pick menualt+right arrow
, ctrl+right arrow
, cmd+right arrow
(macOS) — reveals the selected branch in the Repositories viewright arrow
— reveals the selected branch or tag in the Repositories view, if there is no text in the quick pick menualt+right arrow
, ctrl+right arrow
, cmd+right arrow
(macOS) — reveals the selected branch or tag in the Repositories viewpr://
) — closes #678gitlens.showCommitsInView
option to show the commit in the Search Commits viewgitlens.revealCommitInView
option to to reveal the commit in the Repositories viewgitlens.insiders
is true
)gitlens.showWelcomePage
) commandgitlens.showSettingsPage
) commandgitlens.gitCommands
) experience
gitlens.gitCommands.closeOnFocusOut
setting to specify whether to dismiss the Git Commands menu when focus is lost (if not, press ESC
to dismiss)gitlens.gitCommands.skipConfirmations
setting to specify which (and when) Git commands will skip the confirmation stepleft arrow
— goes back to previous step, if there is no text in the quick pick menualt+left arrow
, ctrl+left arrow
, cmd+left arrow
(macOS) — goes back to previous stepright arrow
— reveals the selected stash in the Repositories view, if there is no text in the quick pick menualt+right arrow
, ctrl+right arrow
, cmd+right arrow
(macOS) — reveals the selected stash in the Repositories viewgitlens.gitCommands
) or Search Commits (gitlens.showCommitSearch
) commands
gitlens.gitCommands.search.matchCase
settinggitlens.gitCommands.search.matchRegex
settinggitlens.gitCommands.search.matchAll
settingright arrow
— shows the selected commit in the Search Commits view, if there is no text in the quick pick menualt+right arrow
— shows the selected commit in the Search Commits viewctrl+right arrow
, cmd+right arrow
(macOS) — reveals the selected commit in the Repositories viewgitlens.revealCommitInView
) command to reveal the current commit in the Repositories view — this can take a while, so it will show a progress notification with the ability to cancel the operation
gitlens.showCommitsInView
) command to show all the commits within the current selection in the Search Commits viewgitlens.showCommitsInView
option to the recent change code lens to show the recent commit in the Search Commits viewgitlens.showCommitsInView
option to the authors code lens to show the commits within the range of the code lens block in the Search Commits viewgitlens.revealCommitInView
option to the recent change code lens to reveal the recent commit in the Repositories viewgitlens.revealCommitInView
option to the authors code lens to reveal the primary author's commit in the Repositories viewgitlens.sortBranchesBy
setting to specify how branches are sorted in quick pick menus and viewsgitlens.sortTagsBy
setting to specify how tags are sorted in quick pick menus and views@users.noreply.github.com
email addresses — partially addresses #281 thanks to PR #814 by bolte-17 (@bolte-17)gitlens.showCommitInView
) command to Show Commit in Search Commits Viewgitlens.showFileHistoryInView
) command to Show in File History Viewgitlens.gitCommands
)
${tips}
format token to show an indicator if the commit is a tip of any branches or tags — closes #792gitlens.views.repositories.showBranchComparison
settinggitlens.views.repositories.showBranchComparison
to also specify the type of comparison — either with the current branch or the working treealt-click
of the Open File command on files in the viewsalt-click
of the Open Revision command on files in the viewsgitlens.showCommitSearch
) to prompt for a repository, if there is more than onegitlens.settings.mode
setting as the interactive settings editor (via the GitLens: Open Settings command) will always show all settings nowalt-click
for Copy Commit Message to Clipboard), and Open File on Remote (if available) commandsgitlens.views.repositories.showBranchComparison
) setting to specify whether to show a comparison of the current branch to a user-selected reference in the Repositories viewgitlens.advanced.useSymmetricDifferenceNotation
setting to specify whether to use the symmetric difference (three-dot) notation or the range (two-dot) notation for comparisons — closes #330"gitlens.insiders": true
) — closes #735
alt-click
for Compare with Working Tree), Copy Commit ID to Clipboard (alt-click
for Copy Commit Message to Clipboard), and Open Commit on Remote (if available) commandsalt-click
for Copy Commit Message to Clipboard), and Open File on Remote (if available) commandsgitlens.showQuickStashList
) and multiple repositoriesgitlens.advanced.maxSearchItems
setting to specify the maximum number of items to show in a search — closes #728gitlens.defaultDateSource
setting to specify whether commit dates should use the authored or committed date — closes #537 thanks to PR #707 by Mathew King (@MathewKing)gitlens.advanced.similarityThreshold
setting to specify the amount (percent) of similarity a deleted and added file pair must have to be considered a rename — closes #670 thanks to PR #714 by x13machine (@x13machine)${originalPath}
token for use with file formatting which provides the full file path of the original file, if renamed-S
flag) as it is too confusing and searching by changes (-G
flag) better matches user expectations — closes #730alt+,
and alt+.
) in commit details of the file history quick pick menualt+,
and alt+.
) in commit details of the branch history quick pick menugitlens.hovers.changesDiff
setting to specify whether to show just the changes to the line or the set of related changes in the changes (diff) hover-m
flag from git log
when following renames (--follow
), because it returns all merge commits, whether the file was changed or notalt-click
for Compare with Working Tree), Copy Commit ID to Clipboard (alt-click
for Copy Commit Message to Clipboard), and Open Commit on Remote (if available) commandsalt-click
for Copy Commit Message to Clipboard), and Open File on Remote (if available) commandsgitlens.views.pageItemLimit
setting to specify the number of items to show in a each page when paginating a view list. Use 0 to specify no limitgitlens.openFileRevisionFrom
) command to allow entering referencesgitlens.diffWithNext
) command when in the diff editorgitlens.diffWithPrevious
) command when in the diff editorgitlens.diffWithWorking
) command when in the diff editorgitlens.diffHeadWithBranch
) command to Compare HEAD with... (gitlens.diffHeadWith
)gitlens.diffWorkingWithBranch
) command to Compare Working Tree with... (gitlens.diffWorkingWith
)gitlens.diffWithBranch
) command to Open Changes with... (gitlens.diffWithRef
)gitlens.openFileRevisionFromBranch
) command to Open Revision from... (gitlens.openFileRevisionFrom
)gitlens.views.compare.selectForCompare
) command to Compare References...#
— closes #690gitlens.diffLineWithPrevious
) command to follow the line history much bettergitlens.views.compare.selectForCompare
) from the command palettegitlen://
uris) — includes the commit idgitlens.openFileRevisionFromBranch
) command to open the revision of the current file from the selected branch — closes #646mailto:
link to the author on the commit details hover — closes #642gitlens.hovers.detailsMarkdownFormat
setting to specify the format (in markdown) of the commit details hover${email}
) — closes #642
gitlens.blame.format
, gitlens.currentLine.format
, gitlens.hovers.detailsMarkdownFormat
, gitlens.views.commitFormat
, gitlens.views.commitDescriptionFormat
, gitlens.views.stashFormat
, gitlens.views.stashDescriptionFormat
, and gitlens.statusBar.format
gitlens.copyRemoteFileUrlToClipboard
) to Copy Remote URL to Clipboard for brevitygitlens.defaultDateShortFormat
setting to specify how short absolute dates will be formatted by defaultgitlens.defaultDateStyle
) and uses the new gitlens.defaultDateShortFormat
setting for formattinggitlens.views.showRelativeDateMarkers
setting to specify whether to show relative date markers (Less than a week ago, Over a week ago, Over a month ago, etc) on revision (commit) histories in the views — closes #571gitlens.diffWithWorking
) to align with VS Codes new Open Changes icongitlens.views.avatars
setting into gitlens.views.compare.avatars
, gitlens.views.repositories.avatars
, and gitlens.views.search.avatars
settings for more granular controlgitlens.stashSave
) to Stash All Changes and adds a new Stash Changes command (gitlens.stashSaveFiles
)gitlens.stashSave
) — closes Microsoft/vscode#64423alt
-command of the Toggle File Blame Annotations commandgitlens.views.commitFileDescriptionFormat
setting to specify the description format of a committed file in the viewsgitlens.views.commitDescriptionFormat
setting to specify the description format of committed changes in the viewsgitlens.views.stashFileDescriptionFormat
setting to specify the description format of a stashed file in the viewsgitlens.views.stashDescriptionFormat
setting to specify the description format of stashed changes in the viewsgitlens.views.statusFileDescriptionFormat
setting to specify the description format of the status of a working or committed file in the viewsgitlens.views.repositories.compact
setting to specify whether to show the Repositories view in a compact display density — closes #571${changes}
token in the gitlens.views.stashFormat
setting)gitlens.menus
setting)gitlens.showQuickRevisionDetails
) to show file commit detailsalt
-command of the Toggle File Blame Annotations command (gitlens.toggleFileBlame
) to be the Toggle File Heatmap Annotations command (gitlens.toggleFileHeatmap
)gitlens.views.exploreRepoRevision
) to Explore Repository from Heregitlens.outputLevel
defaultgitlens.views.exploreRepoRevision
) would fail to load in certain casesgitlens.diffDirectoryWithHead
) command to open the configured git difftool to compare the working directory with HEAD — closes #569gitlens.liveshare.allowGuestAccess
setting to specify whether to allow guest access to GitLens features when using Visual Studio Live Sharegitlens:
scheme — closes #430
gitlens.views.exploreRepoRevision
) command which opens a virtual workspace folder (uses the new Git virtual file system provider) for the repository at the specified point in time (commit, branch, tag, etc) — closes #398gitlens.views.repositories.autoReveal
setting to specify whether to automatically reveal repositories in the Repositories view when opening files${changes}
token in the gitlens.views.commitFormat
setting) — closes #493gitlens.fetchRepositories
) command to fetch all of the open repositoriesgitlens.pullRepositories
) command to pull all of the open repositoriesgitlens.pushRepositories
) command to push all of the open repositories (becareful with this one)gitlens.showLineHistoryView
) command to open the Line History viewgitlens.showCommitInView
) command to open a commit in the Search Commits viewgitlens.showFileHistoryInView
) command to open a file's revision (commit) history in the File History viewgitlens.showCommitInView
) command to quickly open the current line's commit in the Search Commits viewgitlens.showQuickRevisionDetails
) command to quickly show the revision (commit) details of the current file revisiongitlens.diffWithWorking
) command to the editor toolbar when comparing revisions#
, in addition to branches and tags — closes #535gitlens.codeLens.includeSingleLineSymbols
setting to specify whether to provide any Git code lens on symbols that span only a single linegitlens.diffWithBranch
) command to Open Changes with Branch or Tag...gitlens.diffWithNext
) command to Open Changes with Next Revisiongitlens.diffWithPrevious
) command to Open Changes with Previous Revisiongitlens.diffLineWithPrevious
) command to Open Line Changes with Previous Revisiongitlens.diffWithRevision
) command to Open Changes with Revision...gitlens.diffWithWorking
) command to Open Changes with Working Filegitlens.diffLineWithWorking
) command to Open Line Changes with Working Filegitlens.explorers.*
settings to gitlens.views.*
gitlens.gitExplorer.*
settings to gitlens.views.repositories.*
gitlens.historyExplorer.*
settings to gitlens.views.fileHistory.*
and gitlens.views.lineHistory.*
gitlens.resultsExplorer.*
settings to gitlens.views.search.*
and gitlens.views.compare.*
gitlens.showGitExplorer
) command with Show Repositories View (gitlens.showRepositoriesView
)gitlens.showHistoryExplorer
) command with Show File History View (gitlens.showFileHistoryView
)gitlens.showResultsExplorer
) command with Show Search Commits View (gitlens.showSearchView
) and Show Compare View (gitlens.showCompareView
)gitlens.advanced.git
setting as it is no longer neededgitlens.copyRemoteFileUrlToClipboard
) command — copies the remote url of the current file and line to the clipboard — closes #467suppressShowKeyBindingsNotice
gets saved even when it is not requiredgitlens.terminalCheckoutCommit
) to commit node(s) of the GitLens explorer — closes #463gitlens.terminalRebaseCommit
) to apply to all commit node(s) of the GitLens explorergitlens.terminalResetCommit
) to apply to all commit node(s) of the GitLens explorergit log -S
):smile:
in commit messages will now be 😃 — closes #429gitlens.historyExplorer.avatars
setting to specify whether to show avatar images instead of status icons in the GitLens File History
explorer — allows for an independent value from the other explorers--first-parent
from git commands to show file history from merged in repositoriesgitlens.hovers.avatars
setting to specify whether to show avatar images in hovers — closes #432 thanks to PR #441 by Segev Finer (@segevfiner)gitlens.hovers.avatars
setting to the GitLens interactive settings editor to specify whether to show avatar images in hoversgitlens.showQuickFileHistory
) — closes #316gitlens.diffWithRevision
) as an alternate (alt+click
) for the Compare File with Previous Revision command in the editor toolbargitlens.diffWithRevision
) to Choose from Branch or Tag History...gitlens.openFileRevision
) to Choose from Branch or Tag History...gitlens:activeIsTracked
, gitlens:activeIsBlameable
, gitlens:activeIsRevision
, and gitlens:activeHasRemotes
contexts and consolidates them into gitlens:activeFileStatus
for better performance and UX-
SymbolInformation
API changes (see Microsoft/vscode#34968)gitlens.heatmap.ageThreshold
setting to specify the age of the most recent change (in days) after which the gutter heatmap annotations will be cold rather than hot (i.e. will use gitlens.heatmap.coldColor
instead of gitlens.heatmap.hotColor
)gitlens.heatmap.coldColor
setting to specify the base color of the gutter heatmap annotations when the most recent change is older (cold) than the gitlens.heatmap.ageThreshold
settinggitlens.heatmap.hotColor
setting to specify the base color of the gutter heatmap annotations when the most recent change is newer (hot) than the gitlens.heatmap.ageThreshold
settinggitlens.openFileInRemote
) when the current branch has no upstream tracking branch — closes #209gitlens.openWorkingFile
) to the right of the Compare File with * Revision commands in the editor toolbarOpen View
commandchorded
keyboard shortcut for the Compare File with Previous Revision command (gitlens.diffWithPreviousInDiff
) — from #395gitlens.openWorkingFile
) not always showing in the editor toolbar when appropriategitlens.explorers.closeRepository
) command to repository and repository status nodes in the GitLens explorer — closes (hides) the repository in the GitLens explorergitlens.gitExplorer.location
setting to the interactive settings editor to specify where the GitLens explorer is shown — either in the Explorer or Source Control viewgitlens.historyExplorer.location
setting to the interactive settings editor to specify where the GitLens File History explorer is shown — either in the Explorer or Source Control viewgitlens.resultsView.location
setting to the interactive settings editor to specify where the GitLens Results explorer is shown — either in the Explorer or Source Control viewAdds user-defined modes for quickly toggling between sets of settings
Adds Switch Mode command (gitlens.switchMode
) to quickly switch the active GitLens mode
Adds a built-in Zen mode which for a zen-like experience, disables many visual features
gitlens.toggleZenMode
) to toggle Zen modeAdds a built-in Review mode which for reviewing code, enables many visual features
gitlens.toggleReviewMode
) to toggle Review modeAdds the active mode to the status bar, optional (on by default)
gitlens.mode.statusBar.enabled
setting to specify whether to provide the active GitLens mode in the status bargitlens.mode.statusBar.alignment
setting to specify the active GitLens mode alignment in the status barAdds modes settings (gitlens.mode.*
) to the interactive settings editor
Adds gitlens.mode.active
setting to specify the active GitLens mode, if any
Adds gitlens.modes
setting to specify the user-defined GitLens modes
Adds an icon for the Compare File with Previous Revision command (gitlens.diffWithPrevious
) and moves it into the editor toolbar
Adds an icon for the Compare File with Next Revision command (gitlens.diffWithNext
) and moves it into the editor toolbar
Adds menu settings (gitlens.menus.*
) to the interactive settings editor
Adds a display mode dropdown at the top of the interactive settings editor to reduce complexity
gitlens.settings.mode
setting to specify the display mode of the interactive settings editorAdds a tree layout option to tags in the GitLens explorer — closes #358
Adds Show GitLens Explorer (gitlens.showGitExplorer
) command — shows/expands the GitLens explorer
Adds Show File History Explorer (gitlens.showHistoryExplorer
) command — shows/expands the GitLens File History explorer
Adds Show Results Explorer (gitlens.showResultsView
) command — shows/expands the GitLens Results explorer
gitlens.diffLineWithPrevious
) to Compare Commit with Previous for consistency with other commandsgitlens.diffLineWithWorking
) to Compare Commit with Working File for consistency with other commandsgitlens.showQuickCommitFileDetails
) to Show Commit Details for consistency with other commandsgitlens.advanced.menus
setting to gitlens.menus
alt+,
gets stuck"git.enabled": false
) — for #318gitlens.advanced.blame.customArguments
settinggitlens.advanced.blame.customArguments
setting to specify additional arguments to pass to the git blame
command — closes #337Adds new stand-alone GitLens File History explorer to visualize the history of the current file — undocked version of the GitLens explorer history view
Adds richer tooltips to the GitLens and GitLens Results explorers, and richer working tree and upstream status to the GitLens explorer
Adds an indicator to the GitLens explorer's branch history to mark the synchronization point between the local and remote branch (if available)
Adds ability to easily switch between relative and absolute dates via the gitlens.defaultDateStyle
settings — closes #312
${agoOrDate}
and ${authorAgoOrDate}
tokens to gitlens.blame.format
, gitlens.currentLine.format
, gitlens.explorers.commitFormat
, gitlens.explorers.stashFormat
, and gitlens.statusBar.format
settings which will honor the gitlens.defaultDateStyle
settingAdds annotation format settings (gitlens.*.format
) to the interactive settings editor
Adds new gitlens.currentLine.scrollable
setting to specify whether the current line blame annotation can be scrolled into view when it is outside the viewport — closes #149, #290, #265
Adds gitlens.statusBar.reduceFlicker
setting to the interactive settings editor
Adds a one-time notification on startup if the alt-based
keyboard shortcuts are in use, with options to easily switch to another set
Adds Copy Commit ID to Clipboard (gitlens.copyShaToClipboard
) command to changed file nodes in the GitLens explorer and GitLens Results explorer
Adds Copy Commit Message to Clipboard (gitlens.copyMessageToClipboard
) command to changed file nodes in the GitLens explorer and GitLens Results explorer
gitlens.explorers.compareWithHead
) command to Compare with HEAD — closes #309gitlens.diffHeadWithBranch
) command to Compare HEAD with Branch or Tag... — closes #309gitlens.showFileBlame
) command — Toggle File Blame Annotations (gitlens.toggleFileBlame
) provides similar functionalitygitlens.showLineBlame
) command — Toggle Line Blame Annotations (gitlens.toggleLineBlame
) provides similar functionalitygitlens.openWorkingFile
) command from the editor toolbar when the built-in Open File command is visiblegitlens.explorers.compareWithHead
), Compare with Working Tree (gitlens.explorers.compareWithWorking
), and Compare Compare Ancestry with Working Tree (gitlens.explorers.compareAncestryWithWorking
) commands from the current branch since comparing a branch with itself doesn't make sense — closes #309gitlens.codeLens.scopesByLanguage
settingAdds automatic issue linking to Bitbucket, GitHub, GitLab, and Visual Studio Team Services for commit messages in hovers
Adds support to toggle annotations for each file individually or for all files at once — closes #289
gitlens.blame.toggleMode
setting to specify how the gutter blame annotations will be toggled, per file or windowgitlens.heatmap.toggleMode
setting to specify how the gutter heatmap annotations will be toggled, per file or windowgitlens.recentChanges.toggleMode
setting to specify how the recently changed lines annotations will be toggled, per file or windowAdds icons to remotes in the GitLens explorer based on the remote service provider
Adds multi-cursor support to current line annotations — closes #291
gitlens.keymap
settinggitlens.explorers.diffHeadWithBranch
) command - compares the index (HEAD) to the selected branch or tag — thanks to PR #278 by Geoffrey (@g3offrey)!gitlens.explorers.diffWorkingWithBranch
) command - compares the working tree to the selected branch or taggitlens.statusBar.reduceFlicker
setting to specify whether to reduce the status bar "flickering" when changing lines by not first clearing the previous blame information — closes #272gitlens.explorers.openFile
) command to the GitLens explorer's inline toolbar for file nodesgitlen.resultsExplorer.clearResultsNode
) command to the GitLens Results explorer's inline toolbar for results nodesgitlen.resultsExplorer.swapComparison
) command to the GitLens Results explorer's inline toolbar and context menu for comparison results nodesgitlens.explorers.terminalPushCommit
) command to commit nodes on the current branch in the GitLens explorergit.path
setting when searching for the git executableAdds an all-new GitLens welcome page via the Welcome (gitlens.showWelcomePage
) command — provides a welcome / onboarding experience — closes #51
Adds an all-new GitLens Settings editor via the Open Settings (gitlens.showSettingsPage
) command — provides an easy-to-use interactive settings editor for many of GitLens' features — closes #167
Adds a tree layout option to branches in the GitLens explorer — closes #258 thanks to PR #260 by Yukai Huang (@Yukaii)!
Adds Follow Renames command (gitlens.gitExplorer.setRenameFollowingOn
) to the GitLens explorer History view to follow file renames in the history
Adds Don't Follow Renames command (gitlens.gitExplorer.setRenameFollowingOff
) to the GitLens explorer History view to not follow file renames in the history
Adds gitlens.advanced.fileHistoryFollowsRenames
setting to specify whether file histories will follow renames -- will affect how merge commits are shown in histories — closes #259
Adds gitlens.hovers.enabled
setting to specify whether to provide any hovers
Adds gitlens.hovers.annotations.enabled
setting to specify whether to provide any hovers when showing blame annotations
Adds gitlens.hovers.currentLine.enabled
setting to specify whether to provide any hovers for the current line
Adds gitlens.showWhatsNewAfterUpgrades
setting to specify whether to show What's New after upgrading to new feature releases
Adds debug
option to the gitlens.outputLevel
setting — outputs git commands to a new output channel called GitLens (Git)
gitlens.gitExplorer.setFilesLayoutToAuto
) command to Automatic Layoutgitlens.gitExplorer.setFilesLayoutToList
) command to List Layoutgitlens.gitExplorer.setFilesLayoutToTree
) command to Tree Layoutgitlens.resultsView.setFilesLayoutToAuto
) command to Automatic Layoutgitlens.resultsView.setFilesLayoutToAuto
) command to List Layoutgitlens.resultsView.setFilesLayoutToAuto
) command to Tree Layoutgitlens.annotations.file.gutter.gravatars
setting to gitlens.blame.avatars
gitlens.annotations.file.gutter.compact
setting to gitlens.blame.compact
gitlens.annotations.file.gutter.dateFormat
setting to gitlens.blame.dateFormat
gitlens.annotations.file.gutter.format
setting to gitlens.blame.format
gitlens.annotations.file.gutter.heatmap.enabled
setting to gitlens.blame.heatmap.enabled
gitlens.annotations.file.gutter.heatmap.location
setting to gitlens.blame.heatmap.location
gitlens.blame.file.lineHighlight.enabled
setting to gitlens.blame.highlight.enabled
gitlens.blame.file.lineHighlight.locations
setting to gitlens.blame.highlight.locations
gitlens.annotations.file.gutter.separateLines
setting to gitlens.blame.separateLines
gitlens.codeLens.locations
setting to gitlens.codeLens.scopes
gitlens.codeLens.perLanguageLocations
setting to gitlens.codeLens.scopesByLanguage
gitlens.codeLens.customLocationSymbols
setting to gitlens.codeLens.symbolScopes
gitlens.annotations.line.trailing.dateFormat
setting to gitlens.currentLine.dateFormat
gitlens.blame.line.enabled
setting to gitlens.currentLine.enabled
gitlens.annotations.line.trailing.format
setting to gitlens.currentLine.format
gitlens.gitExplorer.gravatars
setting to gitlens.explorers.avatars
gitlens.gitExplorer.commitFileFormat
setting to gitlens.explorers.commitFileFormat
gitlens.gitExplorer.commitFormat
setting to gitlens.explorers.commitFormat
gitlens.gitExplorer.stashFileFormat
setting to gitlens.explorers.stashFileFormat
gitlens.gitExplorer.stashFormat
setting to gitlens.explorers.stashFormat
gitlens.gitExplorer.statusFileFormat
setting to gitlens.explorers.statusFileFormat
gitlens.annotations.file.gutter.hover.changes
setting to gitlens.hovers.annotations.changes
gitlens.annotations.file.gutter.hover.details
setting to gitlens.hovers.annotations.details
gitlens.annotations.file.gutter.hover.wholeLine
setting to gitlens.hovers.annotations.over
gitlens.annotations.line.trailing.hover.changes
setting to gitlens.hovers.currentLine.changes
gitlens.annotations.line.trailing.hover.details
setting to gitlens.hovers.currentLine.details
gitlens.annotations.line.trailing.hover.wholeLine
setting to gitlens.hovers.currentLine.over
gitlens.recentChanges.file.lineHighlight.locations
setting to gitlens.recentChanges.highlight.locations
gitlens.codeLens.debug
setting, use gitlens.debug
insteadgitlens.blame.file.annotationType
setting, use gitlens.hovers.annotations.enabled
gitlens.blame.line.annotationType
setting, use gitlens.currentLine.enabled
or gitlens.hovers.currentLine.enabled
insteadgitlens.resultsView.gravatars
setting, use gitlens.explorers.avatars
insteadgitlens.resultsView.commitFileFormat
setting, use gitlens.explorers.commitFileFormat
insteadgitlens.resultsView.commitFormat
setting, use gitlens.explorers.commitFormat
insteadgitlens.resultsView.showTrackingBranch
settinggitlens.resultsView.stashFileFormat
setting, use gitlens.explorers.stashFileFormat
insteadgitlens.resultsView.stashFormat
setting, use gitlens.explorers.stashFormat
insteadgitlens.resultsView.statusFileFormat
setting, use gitlens.explorers.statusFileFormat
insteadgitlens.annotations.file.hover.changes
setting, use gitlens.hovers.annotations.changes
insteadgitlens.annotations.file.hover.details
setting, use gitlens.hovers.annotations.details
insteadgitlens.annotations.file.hover.heatmap.enabled
settinggitlens.annotations.file.recentChanges.hover.changes
setting, use gitlens.hovers.annotations.changes
insteadgitlens.annotations.file.recentChanges.hover.details
setting, use gitlens.hovers.annotations.details
insteadgitlens.annotations.line.hover.changes
setting, use gitlens.hovers.annotations.changes
insteadgitlens.annotations.line.hover.details
setting, use gitlens.hovers.annotations.details
insteadgitlens.openWorkingFile
) failing when a file was renamedgitlens.showCommitSearch
) when there is no active repositorychorded
keymap on Windows to use Ctrl+Shift+G
rather than Ctrl+Alt+G
to avoid issues
Show SCM
to Ctrl+Shift+G G
since by default it is Ctrl+Shift+G
if the chorded
keymap is usedgitlens.diffWithPrevious
command option for Git code lensgitlens.annotations.file.gutter.gravatars
setting to specify whether to show gravatar images in the gutter blame annotationsgitlens.defaultDateStyle
setting to specify how dates will be displayed by default — closes #89gitlens.explorers.compareWithWorking
) to branch, tag, and revision (commit) nodes in the GitLens explorer to compare the current selection with the current working tree in the GitLens Results explorergitlens.explorers.compareSelectedAncestorWithWorking
) to branch nodes in the GitLens explorer once another branch within the same repository has been selected to compare the merge base of current and previously selected branches with the working tree in the GitLens Results explorer — closes #240gitlens.explorers.terminalMergeBranch
) to branch nodes in the GitLens explorergitlens.explorers.terminalRebaseBranch
) to branch nodes in the GitLens explorergitlens.explorers.terminalRebaseBranch
) to revision (commit) nodes in the GitLens explorer and GitLens Results explorergitlens.explorers.terminalRevertCommit
) to revision (commit) nodes in the GitLens explorer and GitLens Results explorergitlens.explorers.terminalCreateTag
) to branch and revision (commit) nodes in the GitLens explorer and GitLens Results explorergitlens.explorers.terminalDeleteTag
) to tag nodes in the GitLens explorergitlens.terminalRebaseCommit
) to Rebase to Commit (via Terminal)gitlens.terminalResetCommit
) to Reset to Commit (via Terminal)gitlens.diffLineWithWorking
) to Compare Line Revision with Working Filegitlens.openChangesWithWorking
) to Open Changes with Working Filegitlens.gitExplorer.gravatarsDefault
setting, replaced by gitlens.defaultGravatarsStyle
gitlens.resultsView.gravatarsDefault
setting, replaced by gitlens.defaultGravatarsStyle
gitlens.toggleFileHeatmap
) to toggle the heatmap annotations on and offgitlens.showQuickCommitDetails
) in the GitLens Results explorer — closes #237gitlens.explorers.compareWithHead
) to branch, tag, and revision (commit) nodes in the GitLens explorer to compare the current selection with the current index (HEAD) in the GitLens Results explorergitlens.explorers.compareWithRemote
) to branch nodes in the GitLens explorer to compare the current selection with its remote tracking branch in the GitLens Results explorergitlens.advanced.quickPick.closeOnFocusOut
setting should be reversedgitlens.openWorkingFile
) - opens the working file for the active file revision — closes #236gitlens.openFileRevision
) - opens the selected revision for the active filegitlens.diffWithBranch
) — closes #204gitlens.diffDirectory
) — closes #204gitlens.diffWithRevision
) — closes #204gitlens.openFileRevision
) — closes #204gitlens.diffWithBranch
) to Compare File with Branch or Tag...Adds a new Active Repository node to the Repository View of the GitLens explorer — closes #224
Adds a new Tags node to the Repository View of the GitLens explorer — closes #234
Adds Gravatar support to the GitLens explorer
gitlens.gitExplorer.gravatars
setting to specify whether to show gravatar images instead of commit (or status) icons in the GitLens explorergitlens.gitExplorer.gravatarsDefault
setting to specify the style of the gravatar default (fallback) images in the GitLens exploreridenticon
- a geometric patternmm
- (mystery-man) a simple, cartoon-style silhouetted outline of a person (does not vary by email hash)monsterid
- a monster with different colors, faces, etcretro
- 8-bit arcade-style pixelated facesrobohash
- a robot with different colors, faces, etcwavatar
- faces with differing features and backgroundsgitlens.resultsView.gravatars
setting to specify whether to show gravatar images instead of commit (or status) icons in the GitLens Results explorergitlens.resultsView.gravatarsDefault
setting to specify the style of the gravatar default (fallback) images in the GitLens Results exploreridenticon
- a geometric patternmm
- (mystery-man) a simple, cartoon-style silhouetted outline of a person (does not vary by email hash)monsterid
- a monster with different colors, faces, etcretro
- 8-bit arcade-style pixelated facesrobohash
- a robot with different colors, faces, etcwavatar
- faces with differing features and backgroundsAdds Select for Compare command (gitlens.explorers.selectForCompare
) to branch, remote branch, tag, and revision (commit) nodes in the GitLens explorer to mark the base reference of a comparison
Adds Compare with Selected command (gitlens.explorers.compareWithSelected
) to branch, remote branch, tag, and revision (commit) nodes in the GitLens explorer once another reference within the same repository has been selected to compare the current selection with the previously selected reference in the GitLens Results explorer
Adds an all-new, on-demand GitLens Results explorer to the Explorer activity
Provides semi-persistent results for commit search operations, via the Show Commit Search command (gitlens.showCommitSearch
), and file history operations, via the Show File History command (gitlens.showQuickFileHistory
)
Provides semi-persistent results for revision comparison operations, via the Select for Compare command (gitlens.explorers.selectForCompare
) and the Compare with Selected command (gitlens.explorers.compareWithSelected
)
Provides toolbar commands to Search Commits, Keep Results, Refresh, Show Files in Automatic View or Show Files in List View or Show Files in Tree View, and Close
Adds Apply Changes option to the commit/stash file quick pick menu — closes #232
Adds Show All Commits option to the commit search quick pick menu to show all the results, if there are more than the threshold
Adds Show in Results option to the commit search quick pick menu to show the results in the GitLens Results explorer
Adds Show in Results option to the file history quick pick menu to show the history in the GitLens Results explorer
gitlens.diffDirectory
) to Directory Compare Working Tree with...gitlens.keymap
setting to specify the keymap to use for GitLens shortcut keys — closes #104
standard
- adds a standard set of shortcut keyschorded
- adds a chorded set of shortcut keys that all start with Ctrl+Alt+G
(⌥⌘G
on macOS)none
- no shortcut keys will be addedgitlens.showQuickStashList
)gitlens.stashApply
)workbench.colorCustomization
)
gitlens.gutterBackgroundColor
themable colorgitlens.gutterForegroundColor
themable colorgitlens.gutterUncommittedForegroundColor
themable colorgitlens.trailingLineBackgroundColor
themable colorgitlens.trailingLineForegroundColor
themable colorgitlens.lineHighlightBackgroundColor
themable colorgitlens.lineHighlightOverviewRulerColor
themable colorgitlens.advanced.messages
setting to specify which messages should be suppressedgitlens.theme.annotations.file.gutter.separateLines
setting to gitlens.annotations.file.gutter.separateLines
globalState
to use gitlens.advanced.messages
setting for message suppression - provides more control and avoids strange intermittent with globalState
gitlens.strings.codeLens.unsavedChanges.recentChangeAndAuthors
setting default to Unsaved changes (cannot determine recent change or authors)
gitlens.strings.codeLens.unsavedChanges.recentChangeOnly
setting default to Unsaved changes (cannot determine recent change)
gitlens.strings.codeLens.unsavedChanges.authorsOnly
setting default to Unsaved changes (cannot determine authors)
gitlens.theme.*
settings - now using built-in theme supportgitlens.advanced.repositorySearchDepth
setting to specify how many folders deep to search for repositoriesdiff.guitool
first if available, before falling back to diff.tool
— closes #195gitlens.showCommitSearch
)gitlens.showCommitSearch
) — closes #127
~<regex>
to search for commits with differences whose patch text contains added/removed lines that match <regex>
=<regex>
to search for commits with differences that change the number of occurrences of the specified string (i.e. addition/deletion) in a filegitlens.diffWithBranch
) work with renamed files — closes #165gitlens.diffWithBranch
) to source control resource context menugitlens.openRepoInRemote
) to repository node(s) of the GitLens explorergitlens.gitExplorer.setAutoRefreshToOn
) to the GitLens explorer regardless of the current viewgitlens.gitExplorer.setAutoRefreshToOff
) to the GitLens explorer regardless of the current viewgitlens.terminalCheckoutBranch
) to branch node(s) of the GitLens explorergitlens.terminalCreateBranch
) to branch node(s) of the GitLens explorergitlens.terminalDeleteBranch
) to branch node(s) of the GitLens explorergitlens.terminalRebaseBranchToRemote
) to branch node(s) of the GitLens explorergitlens.terminalSquashBranchIntoCommit
) to branch node(s) of the GitLens explorergitlens.terminalRebaseCommit
) to commit node(s) of the GitLens explorergitlens.terminalResetCommit
) to commit node(s) of the GitLens explorergitlens.terminalRemoveRemote
) to remote node(s) of the GitLens explorergitlens.remotes
setting — thanks to PR #192 by Helmut Januschka (@hjanuschka)!gitlens.externalDiffAll
) - opens all working changes with the configured git difftool — closes #164
gitlens.gitExplorer.autoRefresh
setting to specify whether to automatically refresh the GitLens explorer when the repository or the file system changesgitlens.gitExplorer.setAutoRefreshToOn
) to enable the automatic refresh of the GitLens explorergitlens.gitExplorer.setAutoRefreshToOff
) to disable the automatic refresh of the GitLens explorergitlens.gitExplorer.setFilesLayoutToAuto
) to change to an automatic layout for the files in the GitLens explorergitlens.gitExplorer.setFilesLayoutToList
) to change to a list layout for the files in the GitLens explorergitlens.gitExplorer.setFilesLayoutToTree
) to change to a tree layout for the files in the GitLens explorergitlens.diffDirectory
) to Compare Directory with Branch...#00000000
gitlens.advanced.gitignore.enabled
setting since it usage has been replaced by a tracked file cache.gitignore
not working properlygitlens.toggleFileBlame
) wasn't available after a file was savedgitlens.annotations.file.gutter.hover.changes
setting to specify whether to provide a changes (diff) hover annotation over the gutter blame annotationsgitlens.annotations.file.hover.details
setting to specify whether to provide a commit details hover annotation over each linegitlens.annotations.file.hover.changes
setting to specify whether to provide a changes (diff) hover annotation over each linegitlens.codeLens.customLocationSymbols
setting to both include and exclude (using a !
prefix) symbols and therefore is always appliedCustom
from the gitlens.codeLens.locations
setting as it wasn't really requiredProperty
) from being included in the Blocks
option of the gitlens.codeLens.locations
setting — can be easily re-added by setting "gitlens.codeLens.customLocationSymbols": [ "Property" ]
if desiredgitlens.annotations.file.hover.wholeLine
setting as it didn't really make sensegitlens.blame.file.annotationType
wouldn't correctly update the blame annotations if they were currently activeisBlameable
context could be set incorrectly leading to blame icon showing up on invalid documentsAdds a quick-access command bar to the bottom of the details hover annotations
Adds support for remembering file annotations when switching tabs
Adds full GitLens support for file revisions — file & line annotations, commands, etc
gitlens.annotations.file.gutter.hover.wholeLine
setting to default to true
gitlens.showBlameHistory
)gitlens.showFileHistory
)"gitlens.showBlameHistory"
& "gitlens.showFileHistory"
option from gitlens.codeLens.recentChange.command
setting"gitlens.showBlameHistory"
& "gitlens.showFileHistory"
option from gitlens.codeLens.authors.command
setting"gitlens.showBlameHistory"
& "gitlens.showFileHistory"
option from gitlens.statusBar.command
settinggitlens.advanced.toggleWhitespace.enabled
setting — as it is no longer requiredgitlens.remotes
setting — closes #148gitlens.externalDiff
) - opens the changes of a file or set of files with the configured git difftool — thanks to PR #154 by Chris Kaczor (@ckaczor)!
auto
- automatically switches between displaying files as a tree
or list
based on the gitlens.gitExplorer.files.threshold
setting and the number of files at each nesting levellist
- displays files as a listtree
- displays files as a treegitlens.gitExplorer.files.layout
setting to specify how the GitLens explorer will display filesgitlens.gitExplorer.files.compact
setting to specify whether to compact (flatten) unnecessary file nesting in the GitLens explorergitlens.gitExplorer.files.threshold
setting to specify when to switch between displaying files as a tree
or list
based on the number of files in a nesting level in the GitLens explorer${directory}
token to the file formatting settings${path}
token to be the full file path in the file formatting settings"gitlens.insiders": true
) and/or all files in all commits ahead of the upstreamauto
value to gitlens.gitExplorer.view
setting - closes #150gitlens.gitExplorer.enabled
setting to specify whether to show the GitLens explorer - closes #144gitlens.gitExplorer.includeWorkingTree
setting to specify whether to include working tree files inside the Repository Status node of the GitLens explorergitlens.gitExplorer.statusFileFormat
setting to the format of the status of a working or committed file in the GitLens explorergitlens.gitExplorer.view
setting to auto
gitlens.gitExplorer.commitFormat
setting to add parentheses around the commit ideditor/title
& editor/title/context
by default — can be re-enabled via the gitlens.advanced.menus
settinggitlens.advanced.menus
setting wasn't controlling all the menu items properlygitlens.openCommitInRemote
)gitlens.annotations.file.recentChanges.hover.wholeLine
setting as it didn't really make senseAdds an all-new GitLens explorer to the Explorer activity
Repository View - provides a full repository explorer
Repository Status node — provides the status of the repository
Branches node — provides a list of the local branches
Remotes node — provides a list of remotes
Stashes node — provides a list of stashed changes
File History View - provides the revision history of the active file
Quickly switch between views using the Switch to Repository View or Switch to File History View commands
Provides toolbar commands to Search Commits, Switch to Repository View or Switch to File History View, and Refresh
Adds all-new interactivity to the hover annotations
Adds support for remote services with custom domains — closes #120
Adds support for the Bitbucket Server (previously called Stash) remote service — closes #120
Adds gitlens.blame.ignoreWhitespace
setting to specify whether to ignore whitespace when comparing revisions during blame operations — closes #138
Adds Compare File Revisions command (gitlens.diffWith
) - compares the specified file revisions
Adds Open Branches in Remote command (gitlens.openBranchesInRemote
) - opens the branches in the supported remote service
Adds Stash Changes command (gitlens.stashSave
) to the source control group context menu — can now stash a group of files
Adds Stash Changes command (gitlens.stashSave
) to the source control resource context menu — can now stash individual files (works with multi-select too!)
Adds gitlens.gitExplorer.view
setting to specify the starting view (mode) of the GitLens explorer
Adds gitlens.gitExplorer.showTrackingBranch
setting to specify whether to show the tracking branch when displaying local branches in the GitLens explorer
Adds gitlens.gitExplorer.commitFormat
setting to specify the format of committed changes in the GitLens explorer
Adds gitlens.gitExplorer.commitFileFormat
setting to specify the format of a committed file in the GitLens explorer
Adds gitlens.gitExplorer.stashFormat
setting to specify the format of stashed changes in the GitLens explorer
Adds gitlens.gitExplorer.stashFileFormat
setting to specify the format of a stashed file in the GitLens explorer
Adds ${filePath}
token to file formatting settings
gitlens.diffWithPrevious
) to Compare File with Previous Revisiongitlens.diffWithNext
) to Compare File with Next Revisiongitlens.diffWithWorking
) to Compare File with Working Revisiongitlens.diffLineWithPrevious
) to Compare Line Revision with Previousgitlens.diffLineWithWorking
) to Compare Line Revision with Workinggitlens.stashExplorer.stashFormat
settinggitlens.stashExplorer.stashFileFormat
settinggitlens.toggleFileBlame
) icon — pulses while annotations are computedgitlens.toggleFileBlame
) icon — turns orange while the annotations are visiblegitlens.toggleLineBlame
)gitlens.advanced.toggleWhitespace.enabled
configuration setting to default to false
— thanks to the awesome work in vscode by Alexandru Dima (@alexandrudima) this is no longer required!gitlens.stashExplorer.enabled
configuration setting since users can add or remove views natively nowgitlens.stashExplorer.toggle
) since users can add or remove views natively nowgitlens.theme.annotations.file.hover.separateLines
configuration settinggitlens.stashExplorer.enabled
setting to specify whether to show the Git Stashes viewgitlens.stashExplorer.toggle
) - toggles the Git Stashes view on and offgitlens.diffWithRevision
) - compares the active file with the selected revision of the same filegitlens.openChangedFiles
) to the source control group context menugitlens.closeUnchangedFiles
) to the source control group context menugitlens.openFileInRemote
) to the source control resource context menugitlens.diffWithRevision
) to the source control resource context menugitlens.showQuickFileHistory
) to the source control resource context menuCompare File with Branch...
Open Commit in Remote
Show Commit File Details
gitlens.blame.line.enabled
to be clearer about its behaviorgitlens.codeLens.enabled
to be clearer about its behavioralt
command to the Toggle File Blame Annotations command button, which when you hold down alt
and click it will execute the Toggle Recent File Changes Annotations command insteadgitlens.toggleFileRecentChanges
) - toggles the recent changes annotations on and offEscape
to quickly toggle any whole-file annotations offgitlens.defaultDateFormat
setting to specify how all absolute dates will be formatted by defaultgitlens.advanced.menus
settinggitlens.toggleLineBlame
) - toggles the current line blame annotations on and offgitlens.showLineBlame
) - shows the current line blame annotationsgitlens.toggleFileBlame
) - toggles the file blame annotations on and offgitlens.showFileBlame
) - shows the file blame annotationsgitlens.openFileInRemote
) to the editor/title
context menugitlens.openRepoInRemote
) to the editor/title
context menugitlens.strings.*
settings to allow for the customization of certain strings displayedgitlens.theme.*
settings to allow for the theming of certain elementsgitlens.advanced.telemetry.enabled
settings to explicitly opt-in or out of telemetry, but still ultimately honors the telemetry.enableTelemetry
settinggitlens.resetSuppressedWarnings
)gitlens.openFileInRemote
) in the context menus - now in the navigation
groupgitlens.toggleCodeLens
) to always toggle the Git code lens on and offgitlens.advanced.toggleWhitespace.enabled
back to true
, but automatically disables whitespace toggling if whitespace rendering is not ongitlens.toggleBlame
) - replaced by the Toggle File Blame Annotations command (gitlens.toggleFileBlame
)gitlens.showBlame
) - replaced by the Show File Blame Annotations command (gitlens.showFileBlame
)gitlens.diffWithWorking
status bar command option - compares the current line commit with the working treegitlens.diffWithWorking
) - always does what it says :)
File matches the working tree
messagegitlens.diffWithPrevious
) - always does what it says :)
gitlens.diffWithPrevious
status bar command option - compares the current line commit with the previousgitlens.statusBar.alignment
settings to control the alignment of the status bar — thanks to PR #72 by Zack Schuster (@zackschuster)!gitlens.openBranchInRemote
) - opens the current branch commits in the supported remote servicegitlens.openRepoInRemote
) - opens the repository in the supported remote service"gitlens.insiders": true
setting"gitlens.insiders": true
settinggitlens.stashApply
) to apply the selected stashed changes to the working tree — no longer hidden behind the "gitlens.insiders": true
settinggitlens.stashSave
) to stash any working tree changes — no longer hidden behind the "gitlens.insiders": true
settinggitlens.showCommitSearch
) to work without any active editorgitlens.insiders
setting)gitlens.blame.annotation.activeLine
is both
alt+f
shortcut to alt+/
for the Search commits command (gitlens.showCommitSearch
)alt+right
on commit details quick pick menu to execute the Compare File with Previous Commit command (gitlens.diffWithPrevious
) when a file is selectedalt+right
on repository status quick pick menu to execute the Compare File with Previous Commit command (gitlens.diffWithPrevious
) when a file is selectedfiles.encoding
is now honored for the cases where the encoding cannot currently be gleaned"gitlens.statusBar.command": "gitlens.showQuickRepoHistory"
strict
modealt+right arrow
shortcut on the commit details quick pick menu - now opens the file revision from the previous commitgitlens.advanced.codeLens.debug
setting to gitlens.codeLens.debug
gitlens.advanced.debug
setting to gitlens.debug
gitlens.output.level
setting to gitlens.outputLevel
gitlens.blame.annotation.activeLineDarkColor
& gitlens.blame.annotation.activeLineLightColor
settings to control the colors of the active line blame annotationgitlens.codeLens.visibility
is set to auto
(the default)gitlens.blame.annotation.characters.*
settings since they were added to deal with unicode bugs in a previous version of vscode@
for author, :
for file pattern, #
for commit idsha
terminology to commit id
in the UIgitlens.showCommitSearch
) to allow commit searching by message, author, file pattern, or shaalt+f
shortcut for the Search commits command (gitlens.showCommitSearch
)gitlens.insiders
settingdiff.tool
is missinggitlens.showQuickStashList
) to open a quick pick menu of all the stashed changes"gitlens.insiders": true
gitlens.stashApply
) to apply the selected stashed changes to the working treegitlens.stashSave
) to stash any working tree changes"gitlens.insiders": true
gitlens.openFileInRemote
)2.11.0
— terribly sorry for the inconvenience :(2.2.0
2.11.0
"gitlens.insiders": true
gitlens.openCommitInRemote
) to open the current commit in the remote service (currently only GitHub)gitlens.openFileInRemote
) to open the current file in the remote service (currently only GitHub)gitlens.showQuickBranchHistory
) to show the history of the selected branchgitlens.showLastQuickPick
) to re-open the previously opened quick pick menu - helps to get back to previous contextalt+-
shortcut for the Show Last Opened Quick Pick command (gitlens.showLastQuickPick
)gitlens.diffWithBranch
) command to compare working file to another branch (via branch quick pick menu)gitlens.diffDirectory
) commandgitlens.showQuickFileHistory
command execution via code lens to limit results to the code lens blockgitlens.diffWithPrevious
command execution via code lens when the code lens was not at the document/file levelhtml
and vue
language filesgitlens.advanced.codeLens.debug
setting to control whether to show debug information in code lensgitlens.showQuickRepoHistory
command fails to open when there is no active editorgitlens.showQuickFileHistory
& gitlens.showQuickRepoHistory
quick pick menusgitlens.showQuickFileHistory
& gitlens.showQuickRepoHistory
quick pick menus
alt+,
(previous) & alt+.
(next) on the gitlens.showQuickFileHistory
& gitlens.showQuickRepoHistory
quick pick menusalt+,
(previous) & alt+.
(next) on the gitlens.showQuickCommitDetails
& gitlens.showQuickCommitFileDetails
quick pick menusgitlens.showQuickFileHistory
& gitlens.showFileHistory
to no longer show merge commitsgitlens.copyShaToClipboard
to copy the full sha, rather than short shagitlens.diffWithNext
command to open a diff with the next commitalt+.
shortcut for the gitlens.diffWithNext
commandshift+alt+p
shortcut to alt+,
for the gitlens.diffWithPrevious
commandalt+p
shortcut to shift+alt+,
for the gitlens.diffLineWithPrevious
commandgitlens.toggleCodeLens
from Command Palette when not availablegitlens.toggleCodeLens
shortcut key when not availablegitlens.showQuickCommitFileDetails
command to show a quick pick menu of details for a file commitgitlens.showQuickCommitFileDetails
command to code lensgitlens.showQuickCommitFileDetails
command to the status bargitlens.closeUnchangedFiles
command to close any editors that don't have uncommitted changesgitlens.openChangedFiles
command to open all files that have uncommitted changesgitlens.diffDirectory
) command to open the configured git difftool to compare directory versionsgitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.showQuickRepoStatus
quick pick menugitlens.showQuickRepoStatus
quick pick menu for better claritygitlens.showQuickCommitDetails
to show commit a quick pick menu of details for a commitgitlens.codeLens.recentChange.command
to be gitlens.showQuickCommitFileDetails
(though there is no visible behavior change)gitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitFileDetails
quick pick menugitlens.showQuickRepoStatus
quick pick menuCannot determine...
message and become unclickablegitlens.blame.annotation.dateFormat
to specify how absolute commit dates will be shown in the blame annotationsgitlens.statusBar.date
to specify whether and how the commit date will be shown in the blame status bargitlens.statusBar.dateFormat
to specify how absolute commit dates will be shown in the blame status bargitlens.showQuickCommitDetails
quick pick menu to open the commit version of the filegitlens.showQuickCommitDetails
quick pick menu to open the commit version of the filesalt+left
keyboard shortcut in quick pick menus to go backalt+right
keyboard shortcut in quick pick menus to execute the currently selected item while keeping the quick pick menu open (in most cases)
alt+right
keyboard shortcut on commit details file name, will open the commit version of the filegitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menu.
showing in the path of quick pick menusgitlens.showQuickRepoStatus
command to show a quick pick menu of files changed including status icons (added, modified, deleted, etc)alt+s
shortcut for the gitlens.showQuickRepoStatus
commandgitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.diffWithPrevious
and gitlens.diffWithWorking
commandsgitlens.showQuickCommitDetails
quick pick menu for uncommitted changes — now shows the previous commit detailsgitlens.copyMessageToClipboard
command to copy commit message to the clipboardgitlens.copyMessageToClipboard
to the editor content menugitlens.showQuickCommitDetails
quick pick menugitlens.copyShaToClipboard
to copy the sha of the most recent commit to the repository if there is no active editorgitlens.showQuickFileHistory
to execute gitlens.showQuickRepoHistory
if there is no active editorgitlens.showQuickRepoHistory
, gitlens.showQuickFileHistory
, and gitlens.showQuickCommitDetails
quick pick menus
gitlens.showQuickFileHistory
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.showQuickCommitDetails
quick pick menugitlens.diffWithPrevious
command to the editor content menugitlens.diffWithWorking
command to the editor content menugitlens.showQuickRepoHistory
and gitlens.showQuickCommitDetails
commands to code lensgitlens.showQuickRepoHistory
and gitlens.showQuickCommitDetails
commands to the status bargitlens.codeLens.recentChange.command
to gitlens.showQuickCommitDetails
gitlens.statusBar.command
to gitlens.showQuickCommitDetails
gitlens.showQuickCommitDetails
to show commit commands rather than file set (use Show Changed Files
command to get to the file set)gitlens.diffWithPrevious
command to behave as gitlens.diffWithWorking
if the file has uncommitted changesgitlens.diffWithPrevious
command from Diff Commit with Previous
to Compare with Previous Commit
gitlens.diffLineWithPrevious
command from Diff Commit (line) with Previous
to Compare Line with Previous Commit
gitlens.diffWithWorking
command from Diff Commit with Working Tree
to Compare with Working Tree
gitlens.diffLineWithWorking
command from Diff Commit (line) with Working Tree
to Compare Line with Working Tree
.git
folderalt+p
shortcut for the gitlens.diffLineWithPrevious
commandshift+alt+p
shortcut for the gitlens.diffWithPrevious
commandalt+w
shortcut for the gitlens.diffLineWithWorking
commandshift+alt+w
shortcut for the gitlens.diffWithWorking
commandgitlens.copyShaToClipboard
command to copy commit sha to the clipboard (#28)gitlens.showQuickCommitDetails
command to show a quick pick menu of details for a commitgo back
choice to gitlens.showQuickCommitDetails
, gitlens.showQuickFileHistory
, and gitlens.showQuickRepoHistory
quick pick menusgitlens.blame.annotation.highlight
to specify whether and how to highlight blame annotations (#24)gitlens.diffLineWithPrevious
and gitlens.diffWithPrevious
not following renames properlygitlens.diffLineWithPrevious
and gitlens.diffWithPrevious
not always grabbing the correct commitgitlens.blame.annotation.characters.*
settings to provide some control over how annotations are displayedgitlens.blame.annotation.activeLine
to specify whether and how to show blame annotations on the active linegitlens.blame.annotation.activeLine
is not off
trailing
blame annotation style — adds annotations after the code lines rather than beforegitlens.blame.annotation.message
to show the commit message in expanded
and trailing
blame annotation stylesgitlens.blame.annotation.date
gitlens.diffLineWithPrevious
— since vscode issuegitlens.diffLineWithWorking
— since vscode issuegitlens.advanced.toggleWhitespace.enabled
f67f87c549
) where there is a collision of document schemesgitlens.advanced.gitignore.enabled
to enable/disable .gitignore parsing. Addresses #20 - Nested .gitignore files can cause blame to fail with a repo within another repoalt+h
shortcut for the gitlens.showQuickFileHistory
commandshift+alt+h
shortcut for the gitlens.showQuickRepoHistory
commandgitlens.advanced.maxQuickHistory
to limit the number of quick history entries to show (for better performance); Defaults to 200gitlens.diffLineWithPrevious
as alt
context menu item for gitlens.diffWithPrevious
gitlens.diffLineWithWorking
as alt
context menu item for gitlens.diffWithWorking
gitlens.showFileHistory
as alt
context menu item for gitlens.showQuickFileHistory
gitlens.diffLineWithPrevious
— since it is now the alt
of gitlens.diffWithPrevious
gitlens.diffLineWithWorking
— since it is now the alt
of gitlens.diffWithWorking
gitlens.menus.fileDiff.enabled
and gitlens.menus.lineDiff.enabled
with gitlens.menus.diff.enabled
— since the switch between file and line diff is now controlled by the alt
keygitlens.menus.fileDiff.enabled
is true
)gitlens.menus.fileDiff.enabled
is true
)gitlens.showQuickRepoHistory
command to run without an open editor (falls back to the folder repository)gitlens.showQuickFileHistory
command to show the file history in a quick-pick list (palette)gitlens.showQuickRepoHistory
command to show the repository history in a quick-pick list (palette)gitlens.showQuickFileHistory
option to the gitlens.codeLens.recentChange.command
, gitlens.codeLens.authors.command
, and gitlens.statusBar.command
settingsgitlens.statusBar.command
settings default to gitlens.showQuickFileHistory
instead of gitlens.toggleBlame
git.viewFileHistory
option from the gitlens.codeLens.recentChange.command
, gitlens.codeLens.authors.command
, and gitlens.statusBar.command
settingsgitlens.showFileHistory
command to open the history explorergitlens.showFileHistory
option to the gitlens.codeLens.recentChange.command
, gitlens.codeLens.authors.command
, and gitlens.statusBar.command
settingsgitlens.codeLens.languageLocations
settinggitlens.diffLineWithPrevious
command for line sensitive diffsgitlens.diffLineWithWorking
command for line sensitive diffsgitlens.diffWithPrevious
command to the explorer context menugitlens.advanced.output.level
settinggitlens.diffWithPrevious
command to always be file sensitive diffsgitlens.diffWithWorking
command to always be file sensitive diffsgitlens.advanced.debug
settings it ongitlens.diffWithPrevious
option to the gitlens.codeLens.recentChange.command
& gitlens.codeLens.authors.command
settingsgitlens.codeLens.recentChange.command
& gitlens.codeLens.authors.command
settings options (to align with command names)gitlens.blame.annotation.useCodeActions
setting and behaviorgitlens.codeLens.visibility
is set to ondemand