GitLens supercharges the Git capabilities built into Visual Studio Code. It helps you to visualize code authorship at a glance via Git blame annotations and code lens, seamlessly navigate and explore Git repositories, gain valuable insights via powerful comparison commands, and so much more.

Settings

collapse all

For advanced customizations refer to the GitLens docs and edit your User Settings

General

General GitLens settings — defaults and globals

Views Side Bar Layout

Presets Default Layout Source Control Layout Contextual Layout

Default Date/Time Display

Keyboard Shortcuts

Search for gitlens in the Keyboard Shortcuts editor to see the shortcuts and to customize them further

Menus & Toolbars

Any changes to menu & toolbar settings will require a reload before they will take effect

For more advanced customizations open User Settings and search for gitlens

Current Line Blame

Adds an unobtrusive blame annotation at the end of the current line

For more advanced customizations open User Settings and search for gitlens.currentLine Use the GitLens: Toggle Line Blame Annotations command to override this setting for the current window

Gutter Blame

Adds on-demand gutter blame annotations for the whole file

Indicator color reflects the age of the most recent change (hot or cold), while indicator brightness ranges from bright (newer) to dim (older) based on the relative age

For more advanced customizations open User Settings and search for gitlens.blame Use the command to turn the annotations on or off Press Esc to turn off the annotations

Hovers

Adds detailed blame information accessible via hovers

Code Lens

Adds authorship code lens to the top of files and on code blocks

For more advanced customizations open User Settings and search for gitlens.codeLens Use the GitLens: Toggle Git Code Lens command to override this setting for the current window

Gutter Heatmap

Adds on-demand heatmap (age) indicator to the edge of the gutter to show how recently lines were changed
Indicator color reflects the age of the most recent change (hot or cold), while indicator brightness ranges from bright (newer) to dim (older) based on the relative age

Use the command to turn the annotations on or off Press Esc to turn off the annotations

Recent Changes

Adds on-demand recent changes annotations to highlight lines changed by the most recent commit

Use the command to turn the annotations on or off Press Esc to turn off the annotations

Status Bar Blame

Adds a Git blame annotation about the current line to the status bar

For more advanced customizations open User Settings and search for gitlens.statusBar Use the GitLens: Toggle Line Blame Annotations command to override this setting for the current window

Repositories view

Adds a Repositories view to visualize, navigate, and explore Git repositories

For more advanced customizations open User Settings and search for gitlens.views.repositories or gitlens.views

File History view

Adds a File History view to visualize, navigate, and explore the revision history of the current file

Line History view

Adds a Line History view to visualize, navigate, and explore the revision history of the selected lines of current file

Search Commits view

Adds a Search Commits view to search and explore commit histories by message, author, files, id, etc

For more advanced customizations open User Settings and search for gitlens.views.search or gitlens.views

Compare view

Adds a Compare view to visualize comparisons between branches, tags, commits, and more

For more advanced customizations open User Settings and search for gitlens.views.compare or gitlens.views

Modes

Supports user-defined modes for quickly toggling between sets of settings

For more advanced customizations or to add your own modes, open User Settings and search for gitlens.modes Use the GitLens: Switch Mode command to quickly switch the active mode Use the GitLens: Toggle Review Mode command to toggle Review mode Use the GitLens: Toggle Zen Mode command to toggle Zen mode

Jump to

Help

Resources