| `gitlens.codeLens.authors.command` | Specifies the command to be executed when an _authors_ code lens is clicked, set to (`gitlens.toggleFileBlame`) by default. Can be set to `false` to disable click actions on the code lens.<br/><br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.diffWithPrevious` - opens changes with the previous revision<br/>`gitlens.revealCommitInView` - reveals the commit in the Side Bar<br/>`gitlens.showCommitsInView` - searches for commits within the range<br/>`gitlens.showQuickCommitDetails` - shows details of the commit<br/>`gitlens.showQuickCommitFileDetails` - show file details of the commit<br/>`gitlens.showQuickFileHistory` - shows the current file history<br/>`gitlens.showQuickRepoHistory` - shows the current branch history |
| `gitlens.codeLens.authors.enabled` | Specifies whether to provide an _authors_ code lens, showing number of authors of the file or code block and the most prominent author (if there is more than one) |
| `gitlens.codeLens.enabled` | Specifies whether to provide any Git code lens, by default. Use the _Toggle Git Code Lens_ command (`gitlens.toggleCodeLens`) to toggle the Git code lens on and off for the current window |
| `gitlens.codeLens.includeSingleLineSymbols` | Specifies whether to provide any Git code lens on symbols that span only a single line |
| `gitlens.codeLens.recentChange.command` | Specifies the command to be executed when a _recent change_ code lens is clicked, set to (`gitlens.showQuickCommitFileDetails`) by default. Can be set to `false` to disable click actions on the code lens.<br/><br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.diffWithPrevious` - opens changes with the previous revision<br/>`gitlens.revealCommitInView` - reveals the commit in the Side Bar<br/>`gitlens.showCommitsInView` - searches for the commit<br/>`gitlens.showQuickCommitDetails` - shows details of the commit<br/>`gitlens.showQuickCommitFileDetails` - show file details of the commit<br/>`gitlens.showQuickFileHistory` - shows the current file history<br/>`gitlens.showQuickRepoHistory` - shows the current branch history |
| `gitlens.codeLens.recentChange.enabled` | Specifies whether to provide a _recent change_ code lens, showing the author and date of the most recent commit for the file or code block |
| `gitlens.codeLens.scopes` | Specifies where Git code lens will be shown in the document<br/><br/>`document` - adds code lens at the top of the document<br/>`containers` - adds code lens at the start of container-like symbols (modules, classes, interfaces, etc)<br/>`blocks` - adds code lens at the start of block-like symbols (functions, methods, etc) lines |
| `gitlens.codeLens.symbolScopes` | Specifies a set of document symbols where Git code lens will or will not be shown in the document. Prefix with `!` to avoid providing a Git code lens for the symbol. Must be a member of [`SymbolKind`](https://code.visualstudio.com/docs/extensionAPI/vscode-api#_a-namesymbolkindaspan-classcodeitem-id660symbolkindspan) |
| `gitlens.codeLens.authors.command` | Specifies the command to be executed when an _authors_ code lens is clicked, set to (`gitlens.toggleFileBlame`) by default. Can be set to `false` to disable click actions on the code lens.<br/><br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.toggleFileHeatmap` - toggles file heatmap<br/>`gitlens.toggleFileChanges` - toggles file changes since before the commit<br/>`gitlens.toggleFileChangesOnly` - toggles file changes from the commit<br/>`gitlens.diffWithPrevious` - opens changes with the previous revision<br/>`gitlens.revealCommitInView` - reveals the commit in the Side Bar<br/>`gitlens.showCommitsInView` - searches for commits within the range<br/>`gitlens.showQuickCommitDetails` - shows details of the commit<br/>`gitlens.showQuickCommitFileDetails` - show file details of the commit<br/>`gitlens.showQuickFileHistory` - shows the current file history<br/>`gitlens.showQuickRepoHistory` - shows the current branch history<br/>`gitlens.openCommitOnRemote` - opens the commit on the remote service (when available)<br/>`gitlens.copyRemoteCommitUrl` - copies the remote commit url to the clipboard (when available)<br/>`gitlens.openFileOnRemote` - opens the file revision on the remote service (when available)<br/>`gitlens.copyRemoteFileUrl` - copies the remote file url to the clipboard (when available) |
| `gitlens.codeLens.authors.enabled` | Specifies whether to provide an _authors_ code lens, showing number of authors of the file or code block and the most prominent author (if there is more than one) |
| `gitlens.codeLens.enabled` | Specifies whether to provide any Git code lens, by default. Use the _Toggle Git Code Lens_ command (`gitlens.toggleCodeLens`) to toggle the Git code lens on and off for the current window |
| `gitlens.codeLens.includeSingleLineSymbols` | Specifies whether to provide any Git code lens on symbols that span only a single line |
| `gitlens.codeLens.recentChange.command` | Specifies the command to be executed when a _recent change_ code lens is clicked, set to (`gitlens.showQuickCommitFileDetails`) by default. Can be set to `false` to disable click actions on the code lens.<br/><br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.toggleFileHeatmap` - toggles file heatmap<br/>`gitlens.toggleFileChanges` - toggles file changes since before the commit<br/>`gitlens.toggleFileChangesOnly` - toggles file changes from the commit<br/>`gitlens.diffWithPrevious` - opens changes with the previous revision<br/>`gitlens.revealCommitInView` - reveals the commit in the Side Bar<br/>`gitlens.showCommitsInView` - searches for commits within the range<br/>`gitlens.showQuickCommitDetails` - shows details of the commit<br/>`gitlens.showQuickCommitFileDetails` - show file details of the commit<br/>`gitlens.showQuickFileHistory` - shows the current file history<br/>`gitlens.showQuickRepoHistory` - shows the current branch history<br/>`gitlens.openCommitOnRemote` - opens the commit on the remote service (when available)<br/>`gitlens.copyRemoteCommitUrl` - copies the remote commit url to the clipboard (when available)<br/>`gitlens.openFileOnRemote` - opens the file revision on the remote service (when available)<br/>`gitlens.copyRemoteFileUrl` - copies the remote file url to the clipboard (when available) |
| `gitlens.codeLens.recentChange.enabled` | Specifies whether to provide a _recent change_ code lens, showing the author and date of the most recent commit for the file or code block |
| `gitlens.codeLens.scopes` | Specifies where Git code lens will be shown in the document<br/><br/>`document` - adds code lens at the top of the document<br/>`containers` - adds code lens at the start of container-like symbols (modules, classes, interfaces, etc)<br/>`blocks` - adds code lens at the start of block-like symbols (functions, methods, etc) lines |
| `gitlens.codeLens.symbolScopes` | Specifies a set of document symbols where Git code lens will or will not be shown in the document. Prefix with `!` to avoid providing a Git code lens for the symbol. Must be a member of [`SymbolKind`](https://code.visualstudio.com/docs/extensionAPI/vscode-api#_a-namesymbolkindaspan-classcodeitem-id660symbolkindspan) |
## Status Bar Settings [#](#status-bar-settings- 'Status Bar Settings')
| `gitlens.statusBar.alignment` | Specifies the blame alignment in the status bar<br/><br/>`left` - aligns to the left<br/>`right` - aligns to the right |
| `gitlens.statusBar.command` | Specifies the command to be executed when the blame status bar item is clicked<br/><br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.diffWithPrevious` - opens line changes with the previous revision<br/>`gitlens.diffWithWorking` - opens line changes with the working file<br/>`gitlens.revealCommitInView` - reveals the commit in the Side Bar<br/>`gitlens.showCommitsInView` - searches for the commit<br/>`gitlens.toggleCodeLens` - toggles the Git code lens<br/>`gitlens.showQuickCommitDetails` - shows details of the commit<br/>`gitlens.showQuickCommitFileDetails` - show file details of the commit<br/>`gitlens.showQuickFileHistory` - shows the current file history<br/>`gitlens.showQuickRepoHistory` - shows the current branch history |
| `gitlens.statusBar.dateFormat` | Specifies how to format absolute dates (e.g. using the `${date}` token) in the blame information in the status bar. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats |
| `gitlens.statusBar.enabled` | Specifies whether to provide blame information in the status bar |
| `gitlens.statusBar.format` | Specifies the format of the blame information in the status bar. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs. Date formatting is controlled by the `gitlens.statusBar.dateFormat` setting |
| `gitlens.statusBar.pullRequests.enabled` | Specifies whether to provide information about the Pull Request (if any) that introduced the commit in the status bar. Requires a connection to a supported remote service (e.g. GitHub) |
| `gitlens.statusBar.reduceFlicker` | Specifies whether to avoid clearing the previous blame information when changing lines to reduce status bar "flashing" |
| `gitlens.statusBar.tooltipFormat` | Specifies the format (in markdown) of hover shown over the blame information in the status bar. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs |
| `gitlens.statusBar.alignment` | Specifies the blame alignment in the status bar<br/><br/>`left` - aligns to the left<br/>`right` - aligns to the right |
| `gitlens.statusBar.command` | Specifies the command to be executed when the blame status bar item is clicked<br/><br/>`gitlens.toggleFileBlame` - toggles file blame annotations<br/>`gitlens.toggleFileHeatmap` - toggles file heatmap<br/>`gitlens.toggleFileChanges` - toggles file changes since before the commit<br/>`gitlens.toggleFileChangesOnly` - toggles file changes from the commit<br/>`gitlens.diffWithPrevious` - opens changes with the previous revision<br/>`gitlens.revealCommitInView` - reveals the commit in the Side Bar<br/>`gitlens.showCommitsInView` - searches for commits within the range<br/>`gitlens.showQuickCommitDetails` - shows details of the commit<br/>`gitlens.showQuickCommitFileDetails` - show file details of the commit<br/>`gitlens.showQuickFileHistory` - shows the current file history<br/>`gitlens.showQuickRepoHistory` - shows the current branch history<br/>`gitlens.openCommitOnRemote` - opens the commit on the remote service (when available)<br/>`gitlens.copyRemoteCommitUrl` - copies the remote commit url to the clipboard (when available)<br/>`gitlens.openFileOnRemote` - opens the file revision on the remote service (when available)<br/>`gitlens.copyRemoteFileUrl` - copies the remote file url to the clipboard (when available) |
| `gitlens.statusBar.dateFormat` | Specifies how to format absolute dates (e.g. using the `${date}` token) in the blame information in the status bar. See the [Moment.js docs](https://momentjs.com/docs/#/displaying/format/) for valid formats |
| `gitlens.statusBar.enabled` | Specifies whether to provide blame information in the status bar |
| `gitlens.statusBar.format` | Specifies the format of the blame information in the status bar. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs. Date formatting is controlled by the `gitlens.statusBar.dateFormat` setting |
| `gitlens.statusBar.pullRequests.enabled` | Specifies whether to provide information about the Pull Request (if any) that introduced the commit in the status bar. Requires a connection to a supported remote service (e.g. GitHub) |
| `gitlens.statusBar.reduceFlicker` | Specifies whether to avoid clearing the previous blame information when changing lines to reduce status bar "flashing" |
| `gitlens.statusBar.tooltipFormat` | Specifies the format (in markdown) of hover shown over the blame information in the status bar. See [_Commit Tokens_](https://github.com/eamodio/vscode-gitlens/wiki/Custom-Formatting#commit-tokens) in the GitLens docs |
| `gitlens.defaultGravatarsStyle` | Specifies the style of the gravatar default (fallback) images<br/><br/>`identicon` - a geometric pattern<br/>`mm` - a simple, cartoon-style silhouetted outline of a person (does not vary by email hash)<br/>`monsterid` - a monster with different colors, faces, etc<br/>`retro` - 8-bit arcade-style pixelated faces<br/>`robohash` - a robot with different colors, faces, etc<br/>`wavatar` - a face with differing features and backgrounds |
| `gitlens.defaultGravatarsStyle` | Specifies the style of the gravatar default (fallback) images<br/><br/>`identicon` - a geometric pattern<br/>`mp` - a simple, cartoon-style silhouetted outline of a person (does not vary by email hash)<br/>`monsterid` - a monster with different colors, faces, etc<br/>`retro` - 8-bit arcade-style pixelated faces<br/>`robohash` - a robot with different colors, faces, etc<br/>`wavatar` - a face with differing features and backgrounds |
| `gitlens.liveshare.allowGuestAccess` | Specifies whether to allow guest access to GitLens features when using Visual Studio Live Share |
| `gitlens.outputLevel` | Specifies how much (if any) output will be sent to the GitLens output channel |
| `gitlens.showWelcomeOnInstall` | Specifies whether to show the Welcome (Quick Setup) experience on first install |
@ -1120,6 +1120,7 @@ A big thanks to the people that have contributed to this project:
AlwinW
3 years ago
Eric Amodio