Help: identify

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

aliases: id

identify the working copy 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.

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


  • 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

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)

global options:

-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
--config CONFIG [+] set/override config option (use '')
--debug enable debugging output
--debugger start debugger
--encoding ENCODE set the charset encoding (default: ascii)
--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

[+] marked option can be specified multiple times