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.

General

General GitLens settings — defaults and globals

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

GitLens Explorer

Adds a GitLens explorer to navigate and explore repositories or file histories

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

GitLens History Explorer

Adds a GitLens History explorer to visualize the history of the current file

GitLens Results Explorer

Adds an on-demand GitLens Results explorer to navigate and explore commits, histories, and searches, or visualize comparisons between branches, tags, commits, and more

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

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

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

Quickly tell the age of a line — indicator ranges from bright yellow (newer) to dark brown (older)

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

Gutter Heatmap

Adds on-demand heatmap to the edge of the gutter to show the relative age of a line

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

Modes

GitLens 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

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