GH-REPO-FORK(1) GitHub CLI manual GH-REPO-FORK(1)

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#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](#OPTIONS)

[**--clone**](#clone)

Clone the fork

[**--default-branch-only**](#default_branch_only)

Only include the default branch in the fork

[**--fork-name** **<string>**](#fork_name)

Rename the forked repository

[**--org** **<string>**](#org)

Create the fork in an organization

[**--remote**](#remote)

Add a git remote for the fork

[**--remote-name** **<string> (default "origin")**](#remote_name)

Specify the name for the new remote

# [EXIT CODES](#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](#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](#SEE_ALSO)

[**gh-repo(1)**](/man/os/gh/gh-repo.1)

Oct 2026

---

Document: gh-repo-fork(1) from gh 2.103.3-r0 (Chainguard OS)
Source: https://github.com/cli/cli