GH-REPO-CLONE(1) GitHub CLI manual GH-REPO-CLONE(1) NAME gh-repo-clone - Clone a repository locally SYNOPSIS gh repo clone <repository> [<directory>] [-- <gitflags>...] DESCRIPTION Clone a GitHub repository locally. Pass additional git clone flags by list- ing them after --. If the OWNER/ portion of the OWNER/REPO repository argument is omitted, it defaults to the name of the authenticating user. When a protocol scheme is not provided in the repository argument, the git_protocol will be chosen from your configuration, which can be checked via gh config get git_protocol. If the protocol scheme is provided, the repository will be cloned using the specified protocol. If the repository is a fork, its parent repository will be added as an ad- ditional git remote called upstream. The remote name can be configured us- ing --upstream-remote-name. The --upstream-remote-name option supports an @owner value which will name the remote after the owner of the parent repository. If the repository is a fork, its parent repository will be set as the de- fault remote repository. OPTIONS -u, --upstream-remote-name <string> (default "upstream") Upstream remote name when cloning a fork EXIT CODES 0: Successful execution 1: Error 2: Command canceled 4: Authentication required NOTE: Specific commands may have additional exit codes. Refer to the com- mand's help for more information. EXAMPLE # Clone a repository from a specific org $ gh repo clone cli/cli # Clone a repository from your own account $ gh repo clone myrepo # Clone a repo, overriding git protocol configuration $ gh repo clone https://github.com/cli/cli $ gh repo clone git@github.com:cli/cli.git # Clone a repository to a custom directory $ gh repo clone cli/cli workspace/cli # Clone a repository with additional git clone flags $ gh repo clone cli/cli -- --depth=1 SEE ALSO gh-repo(1) Aug 2026 GH-REPO-CLONE(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT CODES | EXAMPLE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gh-repo-clone&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>