Help: paths

hg paths [NAME]

show aliases for remote repositories

Show definition of symbolic path name NAME. If no name is given, show definition of all available names.

Option -q/--quiet suppresses all output when searching for NAME and shows only the path names when listing all definitions.

Path names are defined in the [paths] section of your configuration file and in "/etc/mercurial/hgrc". If run inside a repository, ".hg/hgrc" is used, too.

The path names "default" and "default-push" have a special meaning. When performing a push or pull operation, they are used as fallbacks if no location is specified on the command-line. When "default-push" is set, it will be used for push and "default" will be used for pull; otherwise "default" is used as the fallback for both. When cloning a repository, the clone source is written as "default" in ".hg/hgrc".


"default" and "default-push" apply to all inbound (e.g. 'hg incoming') and outbound (e.g. 'hg outgoing', 'hg email' and 'hg bundle') operations.

See 'hg help urls' for more information.


The following keywords are supported. See also 'hg help templates'.

String. Symbolic name of the path alias.
String. URL for push operations.
String. URL or directory path for the other operations.

Returns 0 on success.


-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)