vscode-gitlens

Added

• Adds a new Contributors node to each repository in the Repositories view
  • Contributors — lists the contributors in the repository, sorted by contributed commits
    • Provides the avatar (if enabled), name, and email address of each contributor
      • An inline toolbar provides quick access to the Copy to Clipboard command
      • A context menu provides access to the Copy to Clipboard, Add as Co-author, and Refresh commands
      • Each contributor expands to list the repository's revision (commit) history filtered by the contributor
        • An inline toolbar provides quick access to the Compare with HEAD (alt-click for Compare with Working Tree), Copy Commit ID to Clipboard (alt-click for Copy Commit Message to Clipboard), and Open Commit on Remote (if available) commands
        • A context menu provides access to more common revision (commit) commands
        • Each revision (commit) expands to list its set of changed files, complete with status indicators for adds, changes, renames, and deletes
          • An inline toolbar provides quick access to the Open File, Copy Commit ID to Clipboard (alt-click for Copy Commit Message to Clipboard), and Open File on Remote (if available) commands
          • A context menu provides access to more common file revision commands
• Adds a Collapse All command to the Repositories view — closes #688
• Adds version links to the CHANGELOG — closes #617 thanks to PR #660 by John Gee (@shadowspawn)
• Adds a gitlens.views.pageItemLimit setting to specify the number of items to show in a each page when paginating a view list. Use 0 to specify no limit

Changed

• Changes related commit highlighting to only appear on cursor movement after file blame annotations are shown — to improve performance and reduce initial visual overload
• Changes Open Revision from... (gitlens.openFileRevisionFrom) command to allow entering references
• Improves the behavior of the Show More Commits & Show More Results commands — no longer loses the context of the last selected item before showing more
• Improves the behavior of the Open Changes with Next Revision (gitlens.diffWithNext) command when in the diff editor
• Improves the behavior of the Open Changes with Previous Revision (gitlens.diffWithPrevious) command when in the diff editor
• Improves the behavior of the Open Changes with Working File (gitlens.diffWithWorking) command when in the diff editor
• Renames Compare HEAD with Branch or Tag... (gitlens.diffHeadWithBranch) command to Compare HEAD with... (gitlens.diffHeadWith)
• Renames Compare Working Tree with Branch or Tag... (gitlens.diffWorkingWithBranch) command to Compare Working Tree with... (gitlens.diffWorkingWith)
• Renames Open Changes with Branch or Tag... (gitlens.diffWithBranch) command to Open Changes with... (gitlens.diffWithRef)
• Renames Open Revision from Branch or Tag... (gitlens.openFileRevisionFromBranch) command to Open Revision from... (gitlens.openFileRevisionFrom)
• Renames Compare Branch or Tag with... (gitlens.views.compare.selectForCompare) command to Compare References...
• Renames Choose from Branch or Tag History... quick pick item to Show File History from... for better clarity and to reflect that references are now allowed
• Changes to use Day.js instead of date-fns for a reduced bundle size

Removed

• Removes the automatic suspension of the current line blame annotations while debugging — closes #382
• Removes the requirement of prefixing reference comparisons with # — closes #690

Fixed

• Fixes #683 - log.showSignature leads to stray files being displayed
• Fixes #691 - Auto-expand tree view on Swap Comparison
• Fixes #695 - Invalid URL in Open File in Remote when selecting origin/.. as comparison branch
• Fixes the behavior of the Open Line Changes with Previous Revision (gitlens.diffLineWithPrevious) command to follow the line history much better
• Fixes missing Compare References... (gitlens.views.compare.selectForCompare) from the command palette
• Fixes font issues in the Welcome to GitLens and GitLens Settings pages due to changes to the webview CSS font variables provided by VS Code
• Fixes the invite link to the VS Code Development Community Slack

Added

• Adds better tooltips for file revisions (gitlen:// uris) — includes the commit id
• Adds an Open Revision from Branch or Tag... (gitlens.openFileRevisionFromBranch) command to open the revision of the current file from the selected branch — closes #646

Fixed

• Fixes issues with the welcome page and the interactive settings in the latest vscode insiders build

Added

• Adds a mailto: link to the author on the commit details hover — closes #642
• Adds support for customizing the layout of the commit details hover
• Adds a gitlens.hovers.detailsMarkdownFormat setting to specify the format (in markdown) of the commit details hover
• Adds the author's e-mail to the tooltip of commits in the views — closes #642
• Adds a new author e-mail format token (${email}) — closes #642
  • Supported in the following settings: gitlens.blame.format, gitlens.currentLine.format, gitlens.hovers.detailsMarkdownFormat, gitlens.views.commitFormat, gitlens.views.commitDescriptionFormat, gitlens.views.stashFormat, gitlens.views.stashDescriptionFormat, and gitlens.statusBar.format

Changed

• Changes the sorting of remotes in the Repositories view to sort the default remote first
• Changes relative date formatting of the last fetched date of repositories in the Repositories view to instead use an absolute format and will additionally add the time of day if less than a day has passed
  • This avoids having to periodically refresh the repository (which causes all of its children to re-render) in order to update the relative time

Fixed

• Fixes #591 - GitLens Error: Unable to open
• Fixes #620 - Wrong URL to open commit on Azure DevOps if cloned via SSH — thanks to PR #621 by Yan Zhang (@Eskibear)
• Fixes #626 - Branch names with only digits always appear first — thanks to PR #627 by Marc Lasson (@mlasson)
• Fixes #631 - Remotes fail to show in gui
• Fixes #633 - Compare File with Previous Revision doesn't work if path contains '#'
• Fixes #635 - Show more commit not working properly
• Fixes an issue where the Open File, Open File on Remote, and Copy Remote Url to Clipboard commands didn't always work on changed files in the Repositories view
• Fixes an issue where the default remote wasn't used first to provide automatic issue linking

Fixed

• Reverts #606 as it causes views to lose their expansion state

Added

• Adds pinning of comparisons in the Compare view — pinned comparisons will persist across reloads
• Adds an Open in Terminal command to repositories in the Repositories view

Changed

• Renames the Copy Remote File URL to Clipboard command (gitlens.copyRemoteFileUrlToClipboard) to Copy Remote URL to Clipboard for brevity

Fixed

• Fixes #606 - ID for xxx is already registered?!
• Fixes #607 - Open file in Remote Doesn't URL encode
• Fixes #608 - Add an option to change the abbreviated commit SHA length — thanks to PR #611 by Skybbles // L5474 (@Luxray5474)
• Fixes #613 - Change Copy Remote URL to Clipboard to always copy a permalink (e.g. revision link)

Added

• Adds favoriting of repositories and branches in the Repositories view to allow for better (user-customized) sorting
• Adds the ability to specify a default remote selection when using the Open * in Remote commands — closes #504
  • Adds Set as Default and Unset as Default commands to remotes in the Repositories view
• Adds the ability to turn on file annotations (blame, heatmap, and recent changes) via user-defined modes — closes #542
• Adds the ability to stage and unstage files by folders in the Repositories view — closes #599 thanks to PR #600 by Tony Brix (@UziTech)
  • Adds Stage All Changes and Unstage All Changes commands to folders in the Repositories view

Added

• Adds a repository indicator in the Repositories view when we are unable to detect repository changes — related to #583
• Adds gitlens.defaultDateShortFormat setting to specify how short absolute dates will be formatted by default

Changed

• Changes the fetch date in the Repositories view to respect the date style setting (gitlens.defaultDateStyle) and uses the new gitlens.defaultDateShortFormat setting for formatting
• Avoids caching when we are unable to detect repository changes — related to #583

Fixed

• Fixes #605 — Show More Commits not working

Added

• Adds a gitlens.views.showRelativeDateMarkers setting to specify whether to show relative date markers (Less than a week ago, Over a week ago, Over a month ago, etc) on revision (commit) histories in the views — closes #571

Changed

• Changes the icon of the Open Changes with Working File command (gitlens.diffWithWorking) to align with VS Codes new Open Changes icon
• Splits the gitlens.views.avatars setting into gitlens.views.compare.avatars, gitlens.views.repositories.avatars, and gitlens.views.search.avatars settings for more granular control

Changed

• Renames the Stash Changes command (gitlens.stashSave) to Stash All Changes and adds a new Stash Changes command (gitlens.stashSaveFiles)
• Changes the icon of the Stash All Changes command (gitlens.stashSave) — closes Microsoft/vscode#64423

Fixed

• Fixes #598 — Apply changes when comparing a file from two branches is not working

Changed

• Switches to use the new built-in clipboard apis — closes #593
• Improves the error messaging when applying a stash, that won't apply cleanly, by including the git output in the message

Fixed

• Fixes missing icon when using the alt-command of the Toggle File Blame Annotations command

Added

• Improves the commit search experience
  • Remembers and restores the last commit search string
  • Adds a Search Commits command to the search results inline toolbar
  • Reopens the commit search when clicking on a search results without results
• Adds a Collapse command to the toolbars of the Compare and Search Commits views — closes #383
• Adds support for the new ability to have descriptions on view nodes — provides a much cleaner layout
  • Adds a gitlens.views.commitFileDescriptionFormat setting to specify the description format of a committed file in the views
  • Adds a gitlens.views.commitDescriptionFormat setting to specify the description format of committed changes in the views
  • Adds a gitlens.views.stashFileDescriptionFormat setting to specify the description format of a stashed file in the views
  • Adds a gitlens.views.stashDescriptionFormat setting to specify the description format of stashed changes in the views
  • Adds a gitlens.views.statusFileDescriptionFormat setting to specify the description format of the status of a working or committed file in the views
• Adds a gitlens.views.repositories.compact setting to specify whether to show the Repositories view in a compact display density — closes #571

Fixed

• Fixes #559 — Html encoding issues with the empty state of the Compare and Search Commits views
• Fixes #574 — Apply Changes not working because of whitespace conflicts
• Fixes #589 — Bad revision for stash

Added

• Adds more detailed branch tracking status (if available) to the Branches list in the Repositories view
  • * Commits Behind — quickly see and explore the specific commits behind the upstream (i.e. commits that haven't been pulled)
    • Only provided if the current branch is tracking a remote branch and is behind it
  • * Commits Ahead — quickly see and explore the specific commits ahead of the upstream (i.e. commits that haven't been pushed)
    • Only provided if the current branch is tracking a remote branch and is ahead of it
• Adds the date and a changes indicator (+x ~x -x) to stashed changes in GitLens views (uses the new ${changes} token in the gitlens.views.stashFormat setting)
• Adds the changed file status (added, modified, renamed, deleted, etc) to the tooltip of each revision in the File History and Line History views
• Adds Git extended regex support to commit searches
• Adds control over the menu commands contributed to the Source Control side bar to the GitLens interactive settings editor (via the gitlens.menus setting)

Changed

• Changes the Show Revision Details command (gitlens.showQuickRevisionDetails) to show file commit details
• Changes the alt-command of the Toggle File Blame Annotations command (gitlens.toggleFileBlame) to be the Toggle File Heatmap Annotations command (gitlens.toggleFileHeatmap)
• Changes searching for commits by message to be case-insensitive
• Renames the Explore the Repository from Here command (gitlens.views.exploreRepoRevision) to Explore Repository from Here
• Reworks the layout of some contributed menu commands

Fixed

• Fixes an issue where gravatar icons would sometimes not show up — thanks to PR #579 by sgtwilko (@sgtwilko)
• Fixes #33 — Commit messages can causes markdown formatting in hovers
• Fixes #501 — Azure DevOps ssh remotes aren't handled properly
• Fixes #523 — File History doesn't show all commits on file
• Fixes #552 — "Open Line Changes with..." doesn't work for renamed files
• Fixes #566 — History error with UNC
• Fixes #572 — Explorer can't expand some branch folders
• Fixes #584 — Unexpected results when opening diff from file history
• Fixes #588 — Output channel doesn't exist with gitlens.outputLevel default
• Fixes an issue where comparing a file with its staged revision doesn't show any content
• Fixes an issue where the workspace folder added by the Explore Repository from Here command (gitlens.views.exploreRepoRevision) would fail to load in certain cases
• Fixes an issue where applying changes of an added file or an untracked file (in a stash) would fail

Fixed

• Fixes #576 — Fails to load with older versions of git
• Fixes an issue where the Copy Commit Message to Clipboard command fails (and probably others too) — a regression caused by the attempted fix for #568

Added

• Adds a Directory Compare All Changes (gitlens.diffDirectoryWithHead) command to open the configured git difftool to compare the working directory with HEAD — closes #569

Changed

• Renames Open Changes (with difftool) command to Open All Changes (with difftool) when shown on the SCM group context menu

Fixed

• Fixes #565 — Regression: Submodules don't work properly (missing repo in view, file and inline blame, etc)
• Fixes #528 — Remotes not showing, being filtred on domain and file, but not complete path
• Fixes an issue where Close Repository command didn't work
• Fixes issues with external files (files not in one of the workspace folders) showing up as a new repository when over a Live Share session

Fixed

• Fixes issues with errors when listing history in repos without any tags

Added

• Adds GitLens over Visual Studio Live Share
  • Live Share guests will now have read-only access to GitLens' features, provided both the host and guest have GitLens installed
  • Adds a gitlens.liveshare.allowGuestAccess setting to specify whether to allow guest access to GitLens features when using Visual Studio Live Share
• Adds a new Git virtual file system provider for the gitlens: scheme — closes #430
  • Replaces GitLens' internal handling of file revisions, which allows for better performance, as well as avoiding the use of temp files. It also provides a much better experience when dealing with file encodings, images, etc.
• Adds an Explore the Repository from Here (gitlens.views.exploreRepoRevision) command which opens a virtual workspace folder (uses the new Git virtual file system provider) for the repository at the specified point in time (commit, branch, tag, etc) — closes #398
• Adds a new Repositories view, formerly the GitLens view, to visualize, navigate, and explore Git repositories — closes #456, #470, #494
  
  • Provides a cleaner information-rich view of your opened repositories, more git commands (fetch, push, pull, checkout, stage, unstage, etc), better visibility and accessibility of existing features, and more
  • Adds a gitlens.views.repositories.autoReveal setting to specify whether to automatically reveal repositories in the Repositories view when opening files
• Adds a new File History view, formerly the History view, to visualize, navigate, and explore the revision history of the current file
  
  • Provides similar features to the former History view as well as quickly toggling file tracking on and off, changing the base (branch, tag, commit, etc) of the file's history, and more
• Adds an all-new Line History view to visualize, navigate, and explore the revision history of the selected lines of current file — closes #354
  
  • Provides similar features to the File History view including quickly toggling line tracking on and off, changing the base (branch, tag, commit, etc) of the selected lines' history, and more
• Adds an all-new Search Commits view to search and explore commit histories by message, author, files, id, etc — closes #455
  
  • Provides somewhat similar features to the former Results view as well as it is now a persistent view, makes it easier to start a commit search, and more
• Adds an all-new Compare view to visualize comparisons between branches, tags, commits, and more
  
  • Provides somewhat similar and powerful features to the former Results view as well as it is now a persistent view, makes it easier to start a comparison, and more
• Reduces the overhead of all GitLens views — GitLens now only tracks changes and updates the views if they are visible, collapsed or hidden views should have almost zero overhead
• Adds relative date markers (Less than a week ago, Over a week ago, Over a month ago, etc) to revision (commit) histories in GitLens views
• Adds branch and tag tip markers to revision (commit) histories in GitLens views — closes #560
• Adds a changes indicator (+x ~x -x) to commits in GitLens views (uses the new ${changes} token in the gitlens.views.commitFormat setting) — closes #493
• Adds the Show Commit in View command to commits in GitLens views to quickly open the commit in the Search Commits view — closes #502
• Adds the Open Changes (with difftool) command to files in GitLens views — closes #389
• Adds an Expand command to some GitLens view nodes to expand them — closes #275
• Adds a Fetch Repositories (gitlens.fetchRepositories) command to fetch all of the open repositories
• Adds a Pull Repositories (gitlens.pullRepositories) command to pull all of the open repositories
• Adds a Push Repositories (gitlens.pushRepositories) command to push all of the open repositories (becareful with this one)
• Adds a Show Line History View (gitlens.showLineHistoryView) command to open the Line History view
• Adds a Show Commit in View (gitlens.showCommitInView) command to open a commit in the Search Commits view
• Adds a Show File History in View (gitlens.showFileHistoryInView) command to open a file's revision (commit) history in the File History view
• Adds a Show Commit in View (gitlens.showCommitInView) command to quickly open the current line's commit in the Search Commits view
• Adds a Show Revision Details (gitlens.showQuickRevisionDetails) command to quickly show the revision (commit) details of the current file revision
• Adds the Open Changes with Working File (gitlens.diffWithWorking) command to the editor toolbar when comparing revisions
• Adds comparisions to commit ids, by prefixing with a #, in addition to branches and tags — closes #535
• Adds support for git mailmap — closes #388
• Adds support for Azure DevOps (formerly VSTS) remotes — closes #501
• Adds better detection of on-prem BitBucket and GitLab remotes — closes #214
• Adds some missing gitmojis — thanks to PR #510 by Loris Bettazza (@Pustur)
• Adds a gitlens.codeLens.includeSingleLineSymbols setting to specify whether to provide any Git code lens on symbols that span only a single line
• Adds smooth scrolling to the interactive settings editor when using the Jump To links

Changed

• Changes the sorting of branch, tags, and files in GitLens views to be a natural sort — closes #547
• Changes the Apply Changes command to truly apply only the patch of the specified change — closes #539
• Changes Azure Pipelines documents to use document scope only by default — thanks to PR #548 by Matt Cooper (@vtbassmatt)
• Renames Compare File with Branch or Tag... (gitlens.diffWithBranch) command to Open Changes with Branch or Tag...
• Renames Compare File with Next Revision (gitlens.diffWithNext) command to Open Changes with Next Revision
• Renames Compare File with Previous Revision (gitlens.diffWithPrevious) command to Open Changes with Previous Revision
• Renames Compare Commit with Previous (gitlens.diffLineWithPrevious) command to Open Line Changes with Previous Revision
• Renames Compare File with Revision... (gitlens.diffWithRevision) command to Open Changes with Revision...
• Renames Compare File with Working Revision (gitlens.diffWithWorking) command to Open Changes with Working File
• Renames Compare Commit with Working File (gitlens.diffLineWithWorking) command to Open Line Changes with Working File
• Renames * in Remote commands to * on Remote
• Renames and migrates gitlens.explorers.* settings to gitlens.views.*
• Renames and migrates gitlens.gitExplorer.* settings to gitlens.views.repositories.*
• Renames and migrates gitlens.historyExplorer.* settings to gitlens.views.fileHistory.* and gitlens.views.lineHistory.*
• Renames and migrates gitlens.resultsExplorer.* settings to gitlens.views.search.* and gitlens.views.compare.*
• Replaces Show GitLens Explorer (gitlens.showGitExplorer) command with Show Repositories View (gitlens.showRepositoriesView)
• Replaces Show File History Explorer (gitlens.showHistoryExplorer) command with Show File History View (gitlens.showFileHistoryView)
• Replaces Show Results Explorer (gitlens.showResultsExplorer) command with Show Search Commits View (gitlens.showSearchView) and Show Compare View (gitlens.showCompareView)
• Switches to use the new git extension's api to get the git path

Fixed

• Fixes #405 - Secondary, blank repository appears repeatedly in Repositories view
• Fixes #430 - File revisions can end up being parsed by language servers (causing errors and warnings, etc)
• Fixes #496 - Short hash length doesn't match git's default length
• Fixes #503 - Open Changes (with difftool) opens one difftool window per changed file
• Fixes #507 - Restrict commit message size
• Fixes #527 - GitLens icon flashes on startup
• Fixes #533 - Some descriptions not using markdown properly in Settings GUI
• Fixes #544 - Some commit messages have one letter missing
• Fixes CHANGELOG issue — thanks to PR #558 by Ash Clarke (@ashclarke)

Removed

• Removes gitlens.advanced.git setting as it is no longer needed

Fixed

• Fixes #477 - Can't load any GitLens features or UI
• Fixes #482 - UI displays "undefined" in results panel when comparing

Added

• Adds Copy Remote File Url to Clipboard (gitlens.copyRemoteFileUrlToClipboard) command — copies the remote url of the current file and line to the clipboard — closes #467

Fixed

• Fixes #471 - Don't use Ctrl+Alt+[character] as a shortcut
• Fixes #478 - suppressShowKeyBindingsNotice gets saved even when it is not required
• Fixes #468 - Commit history for detached HEAD doesn't work properly

Added

• Adds Checkout Commit (via Terminal) command (gitlens.terminalCheckoutCommit) to commit node(s) of the GitLens explorer — closes #463

Changed

• Improves performance of providing blame annotations, especially for large files (a ~33% improvement on some files)
• Changes commit search by sha to jump directly to the commit (if one is found), rather than having to click through to the commit
• Updates settings descriptions to better support the new settings editor in vscode
• Changes Rebase to Commit (via Terminal) command (gitlens.terminalRebaseCommit) to apply to all commit node(s) of the GitLens explorer
• Changes Reset to Commit (via Terminal) command (gitlens.terminalResetCommit) to apply to all commit node(s) of the GitLens explorer

Fixed

• Fixes #462 - Source Control shortcut on macOS (⌃⇧G) shouldn't be overridden
• Fixes #457 - Displays the wrong username (You) — thanks to PR #460 by Zyck (@qzyse2017)
• Fixes #459 - File blame annotation text overflow with letter spacing setting
• Fixes issues with GitLens Welcome and the interactive settings editor with light themes

• Fixes #454 - Search for string returns merge commits (unlike raw git log -S)
• Fixes issue showing changes with untracked stashed files
• Fixes issue showing changes with working file when the file has been renamed