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)