git-url-parse(1) Git Manual git-url-parse(1)
NAME
git-url-parse - Parse and extract git URL components
SYNOPSIS
git url-parse [-c <component>] [--] <url>...
DESCRIPTION
Git supports many ways to specify URLs, some of them non-standard. For
example, git supports the scp style [user@]host:[path] format. This
command eases interoperability with git URLs by enabling the parsing
and extraction of the components of all git URLs.
Any syntactically valid URL is parsed, even if the scheme is not one
git supports for fetching or pushing.
OPTIONS
-c <component>, --component <component>
Extract the <component> component from the given Git URLs.
<component> can be one of: scheme, user, password, host, port,
path.
OUTPUT
When --component is given, the requested component of each URL is
printed on its own line, in the order the URLs were given. If the URL
has no such component (for example, a port in a URL that does not
specify one), an empty line is printed in its place.
When --component is not given, no output is produced. The exit status
is zero if every URL parses successfully and non-zero otherwise,
allowing the command to be used purely as a validator.
EXAMPLES
o Print the host name:
$ git url-parse --component host https://example.com/user/repo
example.com
o Print the path:
$ git url-parse --component path https://example.com/user/repo
/user/repo
$ git url-parse --component path example.com:~user/repo
~user/repo
$ git url-parse --component path example.com:user/repo
/user/repo
o Validate URLs without outputting anything:
$ git url-parse https://example.com/user/repo example.com:~user/repo
SEE ALSO
git-clone(1), git-fetch(1), git-config(1)
GIT
Part of the git(1) suite
Git 2.55.0 2026-06-29 git-url-parse(1)
git 2.55.0 - Generated Wed Jul 1 11:00:35 CDT 2026