Guide to Mercurial

This is a guide to basic use of Mercurial: installing, using repositories, committing, pulling, pushing and merging.


  1. In the Beginning
  2. Local Workflow: Committing Changes
  3. Workflow with a Remote Repo: Pulling and Pushing
  4. Setting up SSH Keys
  5. Cooperating and Merging
  6. Keeping History Clean

Help with This Guide

This guide is written with Markdown syntax. You can

hg clone

to get the source code. If you'd like to improve this guide, email me and I'll give you push rights to this repo, then you can push your improvements. Or leave a Bitbutcket pull reguest. Or just email me:


You are free to modify and redistribute this guide under the Creative Commons Attribution-ShareAlike 3.0 Unported License.