---
name: "gh-repo-fork"
section: "1"
platform: "linux"
package: "github-cli"
version: "2.102.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gh-repo-fork"
---

# gh-repo-fork(1)

Create a fork of a repository

## 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)](/gh-repo/1.md)**