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.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 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 UXSymbolInformation
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.resultsExplorer.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 on 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.showResultsExplorer
) 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.swapComparision
) command to the GitLens Results explorer's inline toolbar and context menu for comparision 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.resultsExplorer.setFilesLayoutToAuto
) command to Automatic Layoutgitlens.resultsExplorer.setFilesLayoutToAuto
) command to List Layoutgitlens.resultsExplorer.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.resultsExplorer.gravatars
setting, use gitlens.explorers.avatars
insteadgitlens.resultsExplorer.commitFileFormat
setting, use gitlens.explorers.commitFileFormat
insteadgitlens.resultsExplorer.commitFormat
setting, use gitlens.explorers.commitFormat
insteadgitlens.resultsExplorer.showTrackingBranch
settinggitlens.resultsExplorer.stashFileFormat
setting, use gitlens.explorers.stashFileFormat
insteadgitlens.resultsExplorer.stashFormat
setting, use gitlens.explorers.stashFormat
insteadgitlens.resultsExplorer.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.resultsExplorer.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.resultsExplorer.gravatars
setting to specify whether to show gravatar images instead of commit (or status) icons in the GitLens Results explorergitlens.resultsExplorer.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
gitlens.showQuickCommitDetails
)gitlens.diffWith
)gitlens.showQuickCommitDetails
)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