---
name: "gh-repo-set-default"
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-set-default"
---

# gh-repo-set-default(1)

Configure default repository for this directory

## NAME

gh-repo-set-default - Configure default repository for this directory

## SYNOPSIS

**gh repo set-default \[\<repository\>\] \[flags\]**

## DESCRIPTION

This command sets the default remote repository to use when querying the GitHub API for the locally cloned repository.

gh uses the default repository for things like:

- •

  viewing and creating pull requests

- •

  viewing and creating issues

- •

  viewing and creating releases

- •

  working with GitHub Actions

### NOTE: gh does not use the default repository for managing repository and environment secrets.

## OPTIONS

- **-u**, **--unset**

  Unset the current default repository

- **-v**, **--view**

  View the current default repository

## 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 default repository
$ gh repo set-default
# Set a repository explicitly
$ gh repo set-default owner/repo
# Set a repository using a git remote name
$ gh repo set-default origin
# View the current default repository
$ gh repo set-default --view
# Show more repository options in the interactive picker
$ git remote add newrepo https://github.com/owner/repo
$ gh repo set-default
```

## SEE ALSO

**[gh-repo(1)](/gh-repo/1.md)**