Mercurial to Git Converter

Convert Mercurial (hg) repositories to Git. Use when migrating from Mercurial to Git, converting hg repos to git format, preserving history and branches duri...

Security Scan

The skill's files and instructions are coherent with its stated purpose (converting Mercurial repos to Git); there are no unexplained credential requests or hidden network endpoints, though the scripts will clone from GitHub, may call sudo/apt/brew, and can remove an existing target repo.

Purpose & Capability

The name/description match the provided scripts and SKILL.md. The three scripts implement author extraction and two conversion flows (standard and large). Auto-installing hg-fast-export from its upstream GitHub repo is reasonable for the stated task.

Instruction Scope

Instructions and scripts operate only on the user-supplied Mercurial repo and a target Git path and on the user's HOME for installation. They do not request unrelated credentials or external endpoints beyond cloning hg-fast-export from GitHub. Two operational notes: hg-to-git-large.sh unconditionally rm -rf the target if it exists (destructive), while hg-to-git.sh prompts before removal; both may run system package commands (sudo apt-get or brew) when attempting to install hg-fast-export.

Install Mechanism

There is no packaged install spec (instruction-only). The scripts clone hg-fast-export from https://github.com/frej/fast-export.git if missing — cloning from GitHub is expected and traceable, but it does write into the user's home (~/.local/share/hg-fast-export). Scripts also attempt apt-get/brew installs if available.

Credentials

The skill requires no credentials or special environment variables. The scripts read standard environment bits (HOME) and the repository paths supplied by the user, which is proportionate to the task.

Persistence & Privilege

always is false and the skill does not request persistent system privileges or modify other skills. It does perform local filesystem changes (cloning into ~/.local/share and creating/removing the target git repo) which are normal for this utility.

Assessment

This skill looks like a legitimate Mercurial→Git conversion utility, but review these practical points before running it: 1) Back up the target path — hg-to-git-large.sh will remove an existing target directory without prompting, and hg-to-git.sh can remove it after confirming. 2) The scripts may attempt to run sudo apt-get or brew to install packages; expect prompts or permission requirements. 3) The scripts clone hg-fast-export from GitHub into your home directory (~/.local/share/hg-fast-export) — confirm you trust that upstream repo. 4) Run hg-authors.sh and manually edit the authors.map to ensure correct emails. 5) If you want to be extra cautious, inspect the three scripts locally and run them in a test environment or container before using on irreplaceable repositories.

Convert Mercurial repositories to Git while preserving full history, branches, and tags.

Prerequisites

• hg (Mercurial) installed
• git installed
• hg-fast-export (auto-installed if missing)

Quick Start

# Basic conversion
hg-to-git.sh /path/to/hg-repo /path/to/git-repo

# Large repository with progress
hg-to-git-large.sh /path/to/hg-repo /path/to/git-repo

# Extract authors first (recommended)
hg-authors.sh /path/to/hg-repo authors.map
# Edit authors.map, then run conversion

Scripts

scripts/hg-to-git.sh

Standard conversion for most repositories.

Usage:

hg-to-git.sh <hg-repo-path> [git-repo-path]

Features:

• Auto-installs hg-fast-export if missing
• Preserves all branches and tags
• Handles author mapping

scripts/hg-to-git-large.sh

Optimized for large repositories with progress feedback.

Usage:

hg-to-git-large.sh <hg-repo-path> [git-repo-path]

Features:

• Shows progress dots during conversion
• Displays revision count upfront
• Summarizes results at end

scripts/hg-authors.sh

Extract and map Mercurial authors to Git format.

Usage:

hg-authors.sh <hg-repo-path> [output-file]

Output format:

"Mercurial Author"="Git Author <email>"

Edit the output file to fix email addresses before conversion.

Workflow

1. Extract authors (optional but recommended):

   hg-authors.sh /path/to/hg-repo authors.map
   

2. Edit author map - Update email addresses in authors.map

3. Run conversion:

   hg-to-git.sh /path/to/hg-repo /path/to/git-repo
   

4. Verify:

   cd /path/to/git-repo
   git log --oneline -10
   git branch -a
   git tag -l
   

Troubleshooting

hg-fast-export not found

The scripts auto-install from GitHub if not present in PATH.

Author mapping issues

Use hg-authors.sh to generate a mapping file, edit it, then pass to fast-export with -A authors.map.

Large repositories

Use hg-to-git-large.sh for better progress visibility.

Branches not converted

Run git branch -a in the new repo. Remote branches may need to be checked out locally.