Help: identify

hg identify [-nibtB] [-r REV] [SOURCE]

aliases: id

identify the working directory or specified revision

Print a summary identifying the repository state at REV using one or two parent hash identifiers, followed by a "+" if the working directory has uncommitted changes, the branch name (if not default), a list of tags, and a list of bookmarks.

When REV is not given, print a summary of the current state of the repository including the working directory. Specify -r. to get information of the working directory parent without scanning uncommitted changes.

Specifying a path to a repository root or Mercurial bundle will cause lookup to operate on that repository/bundle.


The following keywords are supported in addition to the common template keywords and functions. See also 'hg help templates'.

String. Character "+" denoting if the working directory has uncommitted changes.
String. One or two nodes, optionally followed by "+".
List of strings. Parent nodes of the changeset.


  • generate a build identifier for the working directory:
    hg id --id > build-id.dat
  • find the revision corresponding to a tag:
    hg id -n -r 1.3
  • check the most recent revision of a remote repository:
    hg id -r tip

See 'hg log' for generating more information about specific revisions, including full hash identifiers.

Returns 0 if successful.


-r --rev REV identify the specified revision
-n --num show local revision number
-i --id show global revision id
-b --branch show branch
-t --tags show tags
-B --bookmarks show bookmarks
-e --ssh CMD specify ssh command to use
--remotecmd CMD specify hg command to run on the remote side
--insecure do not verify server certificate (ignoring web.cacerts config)
-T --template TEMPLATE display with template

global options ([+] can be repeated):

-R --repository REPO repository root directory or name of overlay bundle file
--cwd DIR change working directory
-y --noninteractive do not prompt, automatically pick the first choice for all prompts
-q --quiet suppress output
-v --verbose enable additional output
--color TYPE when to colorize (boolean, always, auto, never, or debug)
--config CONFIG [+] set/override config option (use '')
--debug enable debugging output
--debugger start debugger
--encoding ENCODE set the charset encoding (default: UTF-8)
--encodingmode MODE set the charset encoding mode (default: strict)
--traceback always print a traceback on exception
--time time how long the command takes
--profile print command execution profile
--version output version information and exit
-h --help display help and exit
--hidden consider hidden changesets
--pager TYPE when to paginate (boolean, always, auto, or never) (default: auto)