Overview

Integrated Mercurial source control

Prerequisites

Note: This extension leverages your machine's Mercurial (hg) installation,
so you need to install Mercurial first.

Features

• Add files and commit from the source control side-bar (i.e. where git normally appears).

• All the basics: commit, add, forget, update, push and pull.

• See changes inline within text editor.

• Interactive log for basic file history and diff.

• Branch, merge heads, merge with branch, resolve + unresolve files.

• Quickly switch branches, push and pull via status bar.

• Supports named-branches or bookmark workflows.

• Automatic incoming/outgoing counters.

• Undo/rollback.

Feedback & Contributing

• Please report any bugs, suggestions or documentation requests via the Github issues (yes, I see the irony).
• Feel free to submit pull requests.

Initialize a new repo

• Just click the Mercurial icon from the source control title area:

Update to a branch/tag/bookmark

• The current branch name is shown in the bottom-left corner.
• Click it to see a list of branches and tags that you can update to.
• When hg.useBookmarks is enabled, this changes to bookmarks.

Settings

hg.enabled { boolean }

• Enables Hg as a source control manager in VS Code.

hg.useBookmarks { boolean }

• Choose between bookmarks vs. named-branches:
  "false" — named-branches mode (default)
  "true" — bookmarks mode

hg.pushPullScope { all | current | default }

• Specifies what to include in Push/Pull operations.
• Depends on the choice of hg.useBookmarks.
• For named-branches mode:   (i.e. hg.useBookmarks = false)
  "all" — all branches / unrestricted (this is the default)
  "current" — only includes changesets for the current branch
  "default" — only includes changesets for the default branch
• For bookmarks mode:   (i.e. hg.useBookmarks = true)
  "all" — all bookmarks / unrestricted (this is the default)
  "current" — only includes changesets for the active bookmark
  "default" — only includes changesets for bookmarks on the default branch

hg.pushPullBranch DEPRECATED { all | current | default }

• Use hg.pushPullScope instead.
• Specifies which branch(es) should be included in Push/Pull operations.
• Included only for backwards compatibility.

hg.autoUpdate { boolean }

• Enables automatic update of working directory to branch/bookmark head after pulling (equivalent to hg pull --update)
  "true" — enabled
  "false" — disabled, manual update/merge required