gh-repo-fork(1)

NAME

gh-repo-fork - Create a fork of a repository

SYNOPSIS

gh repo fork [<repository>] [-- <gitflags>...] [flags]

DESCRIPTION

Create a fork of a repository.

With no argument, creates a fork of the current repository. Otherwise, forks the specified repository.

By default, the new fork is set to be your origin remote and any existing origin remote is renamed to upstream. To alter this behavior, you can set a name for the new fork's remote with --remote-name.

The upstream remote will be set as the default remote repository.

Additional git clone flags can be passed after --.

OPTIONS

--clone

Clone the fork

--default-branch-only

Only include the default branch in the fork

--fork-name <string>

Rename the forked repository

--org <string>

Create the fork in an organization

--remote

Add a git remote for the fork

--remote-name <string> (default "origin")

Specify the name for the new remote

EXIT CODES

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

EXAMPLE

# Fork a repository
$ gh repo fork owner/repo
# Fork a repository and clone it locally
$ gh repo fork owner/repo --clone
# Fork a repository without cloning it, skip the prompt
$ gh repo fork owner/repo --clone=false

SEE ALSO

gh-repo(1)