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

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

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

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

Compacts (flattens) unnecessary nesting when using a tree layouts

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

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

Compacts (flattens) unnecessary nesting when using a tree layouts

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

When enabled the annotation can be scrolled into view when it is outside the viewport

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)

Compacts (deduplicates) matching adjacent blame annotations

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

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

Avoids clearing the previous blame information when changing lines to reduce status bar "flashing"

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

Jump to

Show Your Support

Become a Sponsor One-time Donations

Help

Resources