Skip to content

Worktrees view shows "upgrade your Git" message when opening a virtual GitHub repository #5056

@nikolay-1986

Description

@nikolay-1986

Summary

When a virtual GitHub repository is opened via the GitHub Repositories extension
(or on github.dev / vscode.dev), switching to the Worktrees view displays the
following misleading welcome message:

⚠ Worktrees are not supported by your version of Git. Please upgrade to a more
recent version.

The message is incorrect: Git version is not the issue. Worktrees are simply not
applicable to virtual repositories, which have no local filesystem or Git binary.

Steps to Reproduce

  1. Install the GitHub Repositories extension (github.remotehub)
  2. Open Command Palette → GitHub Repositories: Open Repository on GitHub…
  3. Enter any repository (e.g. gitkraken/vscode-gitlens)
  4. In the GitLens sidebar, open the Worktrees view (or switch to it in the
    grouped SCM view)

Expected: no message, or a message explaining that Worktrees are not available
for virtual repositories
Actual: "⚠ Worktrees are not supported by your version of Git. Please upgrade
to a more recent version."

Image

Environment

  • GitLens version: 2026.3.1805
  • VS Code version:
    1.112.0 (user setup)
    Commit: 07ff9d6178ede9a1bd12ad3399074d726ebe6e43
    Date: 2026-03-17T18:09:23Z
    Electron: 39.8.0
    ElectronBuildId: 13470701
    Chromium: 142.0.7444.265
    Node.js: 22.22.0
    V8: 14.2.231.22-electron.0
    OS: Windows_NT x64 10.0.26200
  • GitHub Repositories extension: installed and active
  • Repository type: virtual (opened via github.remotehub / vscode-vfs:// URI)

Impact

The message is confusing for users who have a modern Git installation and open a
virtual repository — it implies their local Git is outdated when the actual reason
is unrelated to Git version.

Metadata

Metadata

Assignees

Labels

area-virtual-reposIssues or features related to virtual reposarea-worktreesIssues or features related to worktreesneeds-verificationRequest for verificationpending-releaseResolved but not yet released to the stable edition

Type

No fields configured for Bug.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions