gh-pr-checkout - Man Page

Check out a pull request in git

Synopsis

gh pr checkout [<number> | <url> | <branch>] [flags]

Options

-b, --branch <string>

Local branch name to use (default [the name of the head branch])

--detach

Checkout PR with a detached HEAD

-f, ā€‰--force

Reset the existing local branch to the latest state of the pull request

--recurse-submodules

Update all submodules after checkout

Options Inherited from Parent Commands

-R, --repo <[HOST/]OWNER/REPO>

Select another repository using the [HOST/]OWNER/REPO format

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

# Interactively select a PR from the 10 most recent to check out
$ gh pr checkout

# Checkout a specific PR
$ gh pr checkout 32
$ gh pr checkout https://github.com/OWNER/REPO/pull/32
$ gh pr checkout feature

See Also

gh-pr(1)

Referenced By

gh-pr(1).

Mar 2025 GitHub CLI manual